telegram-mcp (chigwell): community Telegram MCP server

• Lists your Telegram chats with basic details

  Shows your chats, groups and channels with basic details such as name and type.

  Try: “Show my most recent Telegram chats”

  Network · list_chats

• Lists your chats a page at a time

  Returns your chats in pages, so a long chat list can be read in pieces.

  Try: “Show the first 20 of my Telegram chats”

  Network · get_chats

• Shows details about one chat

  Returns detailed information about a single chat, group or channel.

  Try: “Give me the details of my chat with the design team”

  Network · get_chat

• Shows a group or channel's full info, including its description

  Returns the full details of a group or channel, including its About text.

  Try: “What is the description of the Python Jobs channel?”

  Network · get_full_chat

• Reads recent messages from a chat

  Returns messages from a chat, a page at a time. In forum groups each message shows which topic it belongs to.

  Try: “Show the latest messages in my family group chat”

  Network · get_messages

• Finds messages in a chat using filters

  Retrieves messages from a chat with optional filters to narrow them down.

  Try: “List messages in the project chat from last week”

  Network · list_messages

• Reads a chat's history, up to a limit you choose

  Returns the chat history up to a set number of messages.

  Try: “Read the last 200 messages in the book club group”

  Network · get_history

• Shows the messages around one message

  Returns the messages just before and after a given message so you can see what was being discussed.

  Try: “Show what was said around that message about the invoice”

  Network · get_message_context

• Searches one chat for messages containing some text

  Looks through a single chat for messages that match the text you give.

  Try: “Find messages in the team chat that mention the budget”

  Network · search_messages

• Searches all your chats for some text

  Searches the text of messages across every chat on your account.

  Try: “Search all my Telegram chats for the flight confirmation”

  Network · search_global

• Shows the pinned messages in a chat

  Returns every pinned message in a chat.

  Try: “What messages are pinned in the announcements channel?”

  Network · get_pinned_messages

• Sends a message from your account

  Sends a message to a chat as you. It supports plain text, HTML or Markdown formatting, date chips and custom emoji.

  Try: “Send Anna a message saying I will be 10 minutes late”

  Write · send_message

• Replies to a specific message

  Sends a reply to one particular message in a chat, as you.

  Try: “Reply to Tom's last message with: sounds good”

  Write · reply_to_message

• Schedules a message to send later

  Queues a message to be sent to a chat at a future time you choose.

  Try: “Schedule a message to Mom for tomorrow 9am saying happy birthday”

  Write · send_scheduled_message

• Forwards a message to another chat

  Forwards one message, or several, from one chat to another.

  Try: “Forward that message from the news channel to my sister”

  Write · forward_message

• Forwards a batch of messages in one go

  Forwards a group of messages from a source chat to a destination chat in a single call.

  Try: “Forward these five messages from the project chat to Sam”

  Write · forward_messages

• Edits a message you sent

  Changes the text of a message you already sent. Formatting and custom emoji are supported.

  Try: “Edit my last message to fix the typo in the time”

  Write · edit_message

• Deletes a message

  Deletes one message by its ID. If the message does not belong to the chat given, nothing is deleted.

  Try: “Delete the message I just sent in the family chat”

  Delete · delete_message

• Deletes several messages at once

  Deletes many messages in one call. If any ID is not from that chat, nothing is deleted.

  Try: “Delete these three messages from the group”

  Delete · delete_messages_bulk

• Clears a chat's whole message history

  Clears all of the messages in a chat.

  Try: “Clear the history of my chat with the old support bot”

  Delete · delete_chat_history

• Reacts to a message with an emoji

  Adds a reaction to a message as you.

  Try: “React with a thumbs up to Lisa's last message”

  Write · send_reaction

• Removes your reaction from a message

  Takes back the reaction you left on a message.

  Try: “Remove my reaction from that message”

  Delete · remove_reaction

• Shows the reactions on a message

  Lists the reactions a message has received.

  Try: “Who reacted to my last post in the channel?”

  Network · get_message_reactions

• Creates a poll in a chat

  Posts a Telegram poll to a chat using the native poll feature.

  Try: “Create a poll in the team chat asking where to eat lunch”

  Write · create_poll

• Votes in a poll

  Casts your vote in an existing poll, replacing your current vote if the poll allows it.

  Try: “Vote for the second option in the lunch poll”

  Write · vote_poll

• Pins a message in a chat

  Pins a message so it stays at the top of the chat.

  Try: “Pin the meeting details message in the team chat”

  Write · pin_message

• Unpins a message

  Removes a single pinned message from a chat.

  Try: “Unpin the old schedule message”

  Write · unpin_message

• Unpins every pinned message in a chat

  Removes all pinned messages from a chat.

  Try: “Unpin everything in the announcements group”

  Write · unpin_all_messages

• Marks a chat as read

  Marks all messages in a chat as read.

  Try: “Mark my chat with Dan as read”

  Write · mark_as_read

• Saves unread messages from chats to a file

  Collects the unread messages from one or more chats and writes them to a JSON file.

  Try: “Export my unread messages from the work chats to a file”

  Write · export_unread_messages

• Saves a draft message in a chat

  Stores a draft in a chat so it appears in the message box next time you open Telegram.

  Try: “Save a draft to Anna saying thanks for dinner”

  Write · save_draft

• Lists your unsent drafts

  Returns all draft messages across your chats, with the chat each belongs to.

  Try: “Which Telegram drafts do I have waiting?”

  Network · get_drafts

• Removes a draft from a chat

  Clears the saved draft in one chat.

  Try: “Clear the draft in my chat with Tom”

  Delete · clear_draft

• Lists messages waiting to be sent in a chat

  Returns the scheduled messages that are still pending in a chat.

  Try: “What messages do I have scheduled in the family chat?”

  Network · get_scheduled_messages

• Cancels scheduled messages

  Deletes one or more scheduled messages from a chat before they are sent.

  Try: “Cancel the scheduled message to Mom”

  Delete · delete_scheduled_message

• Gets a shareable link to a message

  Creates a t.me link that points to a specific message.

  Try: “Get me a link to that message in the channel”

  Network · get_message_link

• Shows who has read a message

  Lists the user IDs of people who have read a given message.

  Try: “Who has read my last message in the group?”

  Network · get_message_read_by

• Turns a voice message into text

  Transcribes a voice message or video note into written text.

  Try: “Transcribe the voice message Carl just sent me”

  Network · transcribe_voice

• Presses a button on a bot's message

  Presses a callback or game button under a message and returns the bot's answer.

  Try: “Press the Confirm button on the bot's last message”

  Write · press_inline_button

• Finds contacts by name, username or phone

  Searches your contacts by name, username or phone number. Saved nicknames are also matched.

  Try: “Find my contact named Priya”

  Network · search_contacts

• Lists all your contacts

  Returns every contact in your Telegram account.

  Try: “Show me all my Telegram contacts”

  Network · list_contacts

• Finds your private chat with a contact

  Locates the one-to-one chat with a contact by name, username or phone.

  Try: “Open my chat with Marcus”

  Network · get_direct_chat_by_contact

• Lists the chats that involve a contact

  Returns all chats connected to a specific contact.

  Try: “Which chats do I share with Marcus?”

  Network · get_contact_chats

• Shows the latest message with a contact

  Returns the most recent message between you and a contact.

  Try: “When did I last talk to Priya and what was said?”

  Network · get_last_interaction

• Lists the groups you share with someone

  Returns the chats you have in common with a specific user.

  Try: “Which groups am I in with Marcus?”

  Network · get_common_chats

• Adds a new contact

  Adds a person to your contacts using their phone number and name.

  Try: “Add Jane Smith, +15551234567, to my contacts”

  Write · add_contact

• Removes a contact

  Deletes a contact from your Telegram account.

  Try: “Delete Jane Smith from my contacts”

  Delete · delete_contact

• Blocks a user

  Blocks a person so they cannot contact you.

  Try: “Block the user @spambot123”

  Write · block_user

• Unblocks a user

  Lifts the block on a person you blocked earlier.

  Try: “Unblock @spambot123”

  Write · unblock_user

• Lists users you have blocked

  Returns the people you currently have blocked.

  Try: “Who have I blocked on Telegram?”

  Network · get_blocked_users

• Sends a contact card to a chat

  Shares a contact, with phone number and name, in a chat as you.

  Try: “Send Jane's contact details to Tom”

  Write · send_contact

• Adds many contacts at once

  Imports a list of contacts, each with a phone number and name.

  Try: “Import these five contacts into my Telegram”

  Write · import_contacts

• Exports all your contacts as JSON

  Returns all of your contacts as a JSON text.

  Try: “Export my Telegram contacts”

  Network · export_contacts

• Remembers a nickname for a person

  Saves what you call someone so other requests can recognise that nickname when you mention a chat.

  Try: “Remember that Mom means my contact Susan Lee”

  Write · set_contact_alias

• Lists the nicknames you saved

  Shows the remembered contacts, one row per person with all of their nicknames.

  Try: “What nicknames have I saved for contacts?”

  Network · list_contact_aliases

• Forgets one saved nickname

  Removes one remembered nickname. It must match exactly.

  Try: “Forget the nickname Mom”

  Delete · delete_contact_alias

• Shows a person's full profile

  Returns a user's full profile, including bio, personal channel link and other details.

  Try: “Show the full profile of @janesmith”

  Network · get_full_user

• Shows whether a user is online

  Returns the online status of a user.

  Try: “Is Marcus online right now?”

  Network · get_user_status

• Lists a user's profile photos

  Returns the profile photos of a user.

  Try: “Show Jane's profile photos”

  Network · get_user_photos

• Shows information about a bot

  Looks up a bot by its username and returns its details.

  Try: “Tell me about the bot @examplebot”

  Network · get_bot_info

• Searches public chats, channels and bots

  Searches for public chats, channels or bots by username or title.

  Try: “Search for public Telegram channels about astronomy”

  Network · search_public_chats

• Joins a public channel or group

  Joins a public channel or supergroup by username or ID.

  Try: “Join the public channel @spacenews”

  Write · subscribe_public_channel

• Sends a file from your computer to a chat

  Sends a local file to a chat as you, with an optional caption.

  Try: “Send report.pdf from my Downloads folder to Anna”

  Write · send_file

• Sends several photos or videos as one album

  Sends multiple photos or videos together as one album, with a caption formatted the same way as for a file.

  Try: “Send these three photos to the family group as an album”

  Write · send_album

• Sends a voice message

  Sends a voice note to a chat. The file must be in OGG/OPUS format.

  Try: “Send this voice note to Sam”

  Write · send_voice

• Sends a sticker

  Sends a sticker to a chat. The file must be a valid .webp sticker.

  Try: “Send this sticker to Anna”

  Write · send_sticker

• Sends a GIF

  Sends a GIF to a chat using the GIF's Telegram document ID.

  Try: “Send that cat GIF to Tom”

  Write · send_gif

• Searches for GIFs

  Searches for GIFs by keyword and returns their Telegram document IDs.

  Try: “Find a GIF of a dancing cat”

  Network · get_gif_search

• Lists your sticker sets

  Returns all of the sticker sets available to you.

  Try: “What sticker sets do I have?”

  Network · get_sticker_sets

• Downloads a photo, video or file from a message

  Saves the media attached to a message to your computer.

  Try: “Download the file Anna sent me in our chat”

  Write · download_media

• Uploads a local file to Telegram

  Uploads a file from your computer to Telegram and returns details about the upload.

  Try: “Upload report.pdf to Telegram”

  Write · upload_file

• Shows details about media in a message

  Returns information about the media attached to a message.

  Try: “What kind of file is attached to that message?”

  Network · get_media_info

• Reads the contents of a document or image in a message

  Opens a document, PDF or image from a message and reads it in memory without saving it to disk.

  Try: “Read the PDF Anna sent and summarise it”

  Network · inspect_document

• Lists a chat's or user's photos as text

  Indexes the photos of a chat or user as text without transferring any image.

  Try: “List the photos in the family group”

  Network · list_photos

• Shows one photo at full size

  Shows a single photo from a chat or user at full resolution.

  Try: “Open the third photo in the trip group”

  Network · open_photo

• Shows many photos as one collage

  Shows several photos from a chat or user as one labelled collage.

  Try: “Show me a collage of the photos in the trip group”

  Network · get_photo_sheet

• Browses or searches custom emoji packs

  Lists installed or featured custom emoji packs, or searches packs by keyword.

  Try: “Find custom emoji packs about cats”

  Network · get_custom_emoji_packs

• Shows the emoji in one custom pack

  Opens a custom emoji pack by short name or link and lists its emoji.

  Try: “Show the emoji in this pack: t.me/addemoji/example”

  Network · get_custom_emoji_pack

• Previews a custom emoji

  Previews or downloads a custom emoji by its Telegram ID.

  Try: “Preview this custom emoji”

  Write · preview_custom_emoji

• Lists the members of a group or channel

  Returns the participants of a group or channel, a page at a time.

  Try: “Who is in the hiking group?”

  Network · get_participants

• Lists the admins of a group or channel

  Returns all admins in a group or channel.

  Try: “Who are the admins of this channel?”

  Network · get_admins

• Shows one member's role and admin rights

  Returns a member's role, rank and full set of admin rights in a supergroup or channel.

  Try: “What admin rights does Dan have in the dev group?”

  Network · get_member_admin_status

• Lists banned users in a group

  Returns everyone who is banned from a group or channel.

  Try: “Who is banned from the dev group?”

  Network · get_banned_users

• Shows the recent admin log of a group

  Returns the latest admin actions recorded in a group or channel.

  Try: “What did admins do recently in the dev group?”

  Network · get_recent_actions

• Creates a new group

  Creates a new group or supergroup and adds the users you name.

  Try: “Create a group called Weekend Trip with Anna and Tom”

  Write · create_group

• Creates a new channel or supergroup

  Creates a new channel or supergroup.

  Try: “Create a channel called Team Updates”

  Write · create_channel

• Invites people to a group or channel

  Adds users to a group or channel.

  Try: “Invite Anna to the hiking group”

  Write · invite_to_group

• Leaves a group or channel

  Makes your account leave a group or channel.

  Try: “Leave the old college group”

  Delete · leave_chat

• Joins a chat from an invite link

  Joins a chat using an invite link.

  Try: “Join this group: t.me/+abc123”

  Write · join_chat_by_link

• Joins a chat from an invite code

  Joins a chat using the hash part of an invite link.

  Try: “Join the chat with this invite code”

  Write · import_chat_invite

• Gets the invite link for a group or channel

  Returns the invite link of a group or channel.

  Try: “Get the invite link for the hiking group”

  Write · get_invite_link

• Creates an invite link for a chat

  Exports an invite link for a group or channel.

  Try: “Make an invite link for the dev group”

  Write · export_chat_invite

• Renames a group or channel

  Changes the title of a chat, group or channel.

  Try: “Rename the hiking group to Mountain Crew”

  Write · edit_chat_title

• Changes a group's description

  Edits the About text of a chat, group or channel.

  Try: “Update the channel description to say we post weekly news”

  Write · edit_chat_about

• Changes a group's picture

  Sets a new photo for a chat, group or channel from an image file.

  Try: “Set this image as the hiking group's photo”

  Write · edit_chat_photo

• Removes a group's picture

  Deletes the photo of a chat, group or channel.

  Try: “Remove the hiking group's photo”

  Delete · delete_chat_photo

• Upgrades a basic group to a supergroup

  Turns a basic group into a supergroup.

  Try: “Upgrade the hiking group to a supergroup”

  Write · upgrade_group_to_supergroup

• Makes someone an admin

  Promotes a user to admin in a group or channel.

  Try: “Make Dan an admin of the dev group”

  Write · promote_admin

• Removes someone's admin role

  Demotes an admin back to a regular member in a group or channel.

  Try: “Remove Dan as admin of the dev group”

  Write · demote_admin

• Sets exactly what an admin can do

  Sets detailed admin rights for a user in a supergroup or channel.

  Try: “Let Dan pin messages but not ban users”

  Write · edit_admin_rights

• Bans a user from a group

  Bans a user from a group or channel.

  Try: “Ban @spammer from the dev group”

  Delete · ban_user

• Lets a banned user back in

  Lifts a ban on a user in a group or channel.

  Try: “Unban @spammer from the dev group”

  Write · unban_user

• Removes a user without banning them

  Removes a user from a group or channel without banning them, so they can rejoin.

  Try: “Remove Tom from the hiking group but don't ban him”

  Delete · remove_user

• Sets what members can do by default

  Sets the default permissions for members of a group, supergroup or channel.

  Try: “Stop members of the group from sending stickers”

  Write · set_default_chat_permissions

• Turns slow mode on or off

  Enables or disables slow mode in a supergroup.

  Try: “Turn on slow mode in the dev group”

  Write · toggle_slow_mode

• Mutes a chat

  Turns off notifications for a chat.

  Try: “Mute the noisy sales group”

  Write · mute_chat

• Unmutes a chat

  Turns notifications back on for a chat.

  Try: “Unmute the family group”

  Write · unmute_chat

• Archives a chat

  Moves a chat into your archive.

  Try: “Archive my chat with the old landlord”

  Write · archive_chat

• Brings a chat back from the archive

  Moves an archived chat back to your main list.

  Try: “Unarchive the project chat”

  Write · unarchive_chat

• Lists your chat folders

  Returns all of your chat folders with their IDs, names and emoji.

  Try: “What chat folders do I have?”

  Network · list_folders

• Shows what is in one folder

  Returns details of a folder, including all the chats it contains.

  Try: “Which chats are in my Work folder?”

  Network · get_folder

• Shows all folder definitions and their order

  Returns the full definition and order of all your folders, without chat content.

  Try: “Give me an overview of how my folders are set up”

  Network · get_folder_snapshot

• Previews a shared folder link

  Shows what a shared folder invite contains without joining it.

  Try: “What is in this shared folder: t.me/addlist/abc?”

  Network · get_chatlist_invite

• Creates a chat folder

  Creates a new folder for your chats.

  Try: “Create a folder called Family”

  Write · create_folder

• Changes an existing folder

  Updates a private folder by ID and leaves any field you did not mention as it was.

  Try: “Rename my Work folder to Office”

  Write · update_folder

• Puts a chat in a folder

  Adds a chat to an existing folder.

  Try: “Add the dev group to my Work folder”

  Write · add_chat_to_folder

• Takes a chat out of a folder

  Removes a chat from a folder.

  Try: “Remove the dev group from my Work folder”

  Write · remove_chat_from_folder

• Changes the order of your folders

  Rearranges the folders in your folder list.

  Try: “Move my Family folder to the top”

  Write · reorder_folders

• Deletes a folder

  Deletes a folder. The chats in it are kept.

  Try: “Delete my Old Projects folder”

  Delete · delete_folder

• Shows your own account details

  Returns information about the account you are signed in as.

  Try: “Who am I logged in as on Telegram?”

  Network · get_me

• Changes your name or bio

  Updates your profile name and bio.

  Try: “Change my Telegram bio to Product designer in Berlin”

  Write · update_profile

• Sets your profile picture

  Sets a new profile photo from an image file.

  Try: “Use this image as my Telegram profile photo”

  Write · set_profile_photo

• Removes your profile picture

  Deletes your current profile photo.

  Try: “Remove my Telegram profile photo”

  Delete · delete_profile_photo

• Shows your last seen privacy setting

  Returns your privacy settings for last seen status.

  Try: “Who can see when I was last online?”

  Network · get_privacy_settings

• Adds exceptions to a privacy setting

  Adds per-user exceptions to a privacy setting such as last seen, phone number or profile photo.

  Try: “Let Anna see my last seen even though it is hidden”

  Write · set_privacy_settings

• Chooses who you post as in a supergroup

  Saves which identity your account posts as in a supergroup.

  Try: “Post as my channel in the discussion group from now on”

  Write · set_default_send_as

• Lists who you can post as in a chat

  Lists the identities Telegram lets you post as in a given chat, where supported.

  Try: “Who can I post as in this supergroup?”

  Network · get_send_as

• Sets the command list of a bot you own

  Sets bot commands for a bot you own. It only works when the client is signed in as a bot account.

  Try: “Set the commands for my bot”

  Write · set_bot_commands

• Lists topics in a forum group

  Returns the forum topics of a supergroup that has topics turned on.

  Try: “What topics are in the community forum group?”

  Network · list_topics

• Creates a topic in a forum group

  Creates a new topic in a supergroup with topics enabled.

  Try: “Create a topic called Announcements in the community group”

  Write · create_forum_topic

• Edits a forum topic

  Changes a forum topic. Only the fields you give are changed.

  Try: “Rename the General Chat topic to Lounge”

  Write · edit_forum_topic

• Deletes a forum topic and its messages

  Deletes a forum topic together with all of its messages. This cannot be undone.

  Try: “Delete the Old Ideas topic from the community group”

  Delete · delete_forum_topic

• Turns on topics for a supergroup

  Enables forum topics in a supergroup.

  Try: “Turn on topics in the community group”

  Write · enable_forum_topics

• Used by the assistant behind the scenes

  Lists the emoji allowed as topic icons

  Lists the custom emoji Telegram allows as forum topic icons.

  Network · list_forum_topic_icons

• Looks up the ID behind a username

  Turns a username into a user or chat ID.

  Network · resolve_username

• Lists the buttons under a message

  Lists the buttons on a message, with their position and kind, so one can be pressed.

  Network · list_inline_buttons

• Shows the typing indicator in a chat

  Shows the typing indicator in a chat for a few seconds, then clears it.

  Write · send_typing

• Lists the IDs of all your contacts

  Returns the IDs of all contacts in your account.

  Network · get_contact_ids

• Shows your folder and pin limits

  Reads the folder, chat and pin limits that apply to your account.

  Network · get_folder_limits

• Lists the Telegram accounts set up

  Lists the configured Telegram accounts with their profile info.

  Read · list_accounts

• Gets messages newer than a given one

  Returns messages in a chat newer than a message ID, oldest first, as JSON records.

  Network · get_messages_after

• Waits for new messages in chosen chats

  Waits for new messages in followed chats and returns when some arrive.

  Network · wait_for_events

• Waits for a new private message

  Waits until a new private message from a non-bot user arrives, then returns it.

  Network · wait_for_new_message

• Waits until a private chat goes quiet

  Waits for incoming private messages and returns once a burst of them has settled.

  Network · wait_for_settled_message

• Turns on a file feed of incoming messages

  Starts a background task that writes each incoming burst of messages to a feed file. It is meant for Claude Code only.

  Write · enable_incoming_feed

• Turns off the incoming message feed

  Stops writing incoming messages to the feed file.

  Write · disable_incoming_feed

• Shows whether the incoming feed is on

  Reports whether the incoming message feed is on, and where its file is.

  Files · incoming_feed_status

Watch out for

• It acts as you, on your whole account

  The session string is a full login to your Telegram account. Anyone who gets it can read and send as you, so keep it out of git and shared configs. github.com

• It can delete messages for everyone

  Its delete tools remove messages on both sides by default. Use read-only mode unless you need it to change things. github.com

• Telegram may limit or ban the account

  Telegram flags fast or bulk activity from third-party apps. Use an account you have had for a while and avoid mass messaging; @SpamBot tells you if you are limited. docs.telethon.dev

• The PyPI package is someone else's

  The telegram-mcp name on PyPI belongs to a different project. Install only from the GitHub repo, or that package could receive your Telegram login. github.com

• Unconfirmed report of two security flaws

  A researcher reported a cross-site request issue in the shared web mode and a chat-allowlist bypass but has not published details, and neither is confirmed. Until it is resolved, prefer the default local mode over the shared web mode. github.com

• Chat allowlist had gaps (fixed)

  Some tools could reach chats outside the allowlist until a fix in October 2026. Update to the latest release. github.com

Security advisories

In their words