Telegram MCP Server

Integrates Telegram with Claude Desktop, enabling it to read and send messages.

Local serverstdioPython★ 7

What is the Telegram MCP Server?

Integrates Telegram with Claude Desktop, enabling it to read and send messages.

Credentials and setup notes

  • Python 3.10+ - Claude Desktop - Telegram account

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_meInfo about the authenticated account
get_chatsPaginated list of chats (names, ids, unread counts, pinned state); supports archived chats
get_messagesPaginated message history for a chat (marks it read); includes media and reaction info
search_messagesSearch by text, globally or within a single chat
get_pinned_messagesList pinned messages in a chat
get_entity_infoLook up a user/group/channel by id, username, phone, or link
get_participantsList members of a group or channel
send_messageSend text (Markdown), optionally as a reply
edit_messageEdit a message you sent
delete_messagesDelete messages (for everyone or just you)
forward_messagesForward messages between chats
send_reactionAdd or clear an emoji reaction
mark_messages_readMark a chat's unread messages as read
send_fileSend a photo, video, document, or voice note from disk
download_mediaDownload a message's attached media to disk
get_contactsList saved contacts
create_groupCreate a basic group
create_channelCreate a channel or supergroup
archive_chatArchive / unarchive a chat
mute_chatMute / unmute notifications
get_conversation_contextRecent messages + your convostyle.txt guide so Claude can match your texting style

How to install the Telegram MCP Server

{
  "mcpServers": {
    "telegram": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-telegram",
        "run",
        "telegram-mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.10+ - Claude Desktop - Telegram account

Example prompts to try

  • “Use Telegram to get me.”
  • “Use Telegram to get chats.”
  • “Use Telegram to get messages.”

Frequently asked questions

You'll need to get your Telegram API credentials, set up a Python environment with the necessary packages, configure environment variables with your API keys, and add the integration to your Claude Desktop configuration file.