mcp-telegram

Overview

Built with Telethon, this MCP server provides comprehensive Telegram integration through the Model Context Protocol. It enables AI agents to perform various Telegram operations including sending, editing and deleting messages, searching chats and messages, managing drafts, and downloading media. The server exposes well-documented tools that can be used by MCP-compatible clients like Claude Desktop and Cursor.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• send_message

  Send text messages or files to any user, group, or channel

  Try:Send a message to my friend JohnTry:Share a document with the team group
• edit_message

  Modify content of previously sent messages

  Try:Fix the typo in my last messageTry:Update the meeting time in my message
• delete_message

  Remove one or multiple messages

  Try:Delete my last message by mistakeTry:Clean up old messages in the group
• get_messages

  Retrieve message history with advanced filtering options

  Try:Get my message history with JaneTry:Show all messages from this week
• search_dialogs

  Find users, groups, and channels by name or username

  Try:Find the Python programming groupTry:Search for contacts named Sarah
• message_from_link

  Access specific messages using Telegram links

  Try:Open message from this linkTry:Retrieve the message shared in this t.me link
• get_draft

  View current message draft for any chat

  Try:What's my draft in the family group?Try:Check my draft message to work
• set_draft

  Create or clear message drafts

  Try:Set a draft message about our meetingTry:Clear my draft in the project channel
• media_download

  Download photos, videos, and documents from messages

  Try:Download the video from my friendTry:Save the document from the last message

Comparable tools

Installation

uv tool install mcp-telegram

mcp-telegram login

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "mcp-telegram",
      "args": ["start"],
      "env": {
        "API_ID": "<your_api_id>",
        "API_HASH": "<your_api_hash>"
      }
    }
  }
}

FAQ

Where do I get API ID and API hash for Telegram?

You can obtain API ID and API hash by creating an application at https://my.telegram.org/apps

Can I use multiple accounts with this MCP server?

Yes, you can manage multiple accounts by using different session files. Use the `--session` parameter or clear existing sessions with `mcp-telegram clear-session`

What privacy concerns should I be aware of?

Telegram's ToS prohibit automated bots and mass messaging. Keep your API credentials private and avoid activities that might get your account restricted

Compare mcp-telegram with