MCP Catalogs
← Hometelegram-mcp screenshot

telegram-mcp

by chaindead·★ 326·Score 50

A Go-based MCP server that bridges Telegram API with AI assistants for managing messages, dialogs, and drafts.

communicationproductivity
45
Forks
8
Open issues
3 mo ago
Last commit
2d ago
Indexed

Overview

The telegram-mcp server provides a secure connection between Telegram and AI assistants through the Model Context Protocol. It offers various tools for message management including retrieving account information, listing dialogs with unread filters, marking messages as read, and sending draft messages. The server follows Telegram API terms of service and requires authentication through app ID and API hash. The implementation is in Go and supports multiple installation methods including Homebrew, NPX, and direct binary downloads for macOS, Linux, and Windows.

Try asking AI

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

you:Checking and summarizing unread Telegram messages through an AI assistant
you:Organizing Telegram chats by importance and categorization with AI suggestions
you:Monitoring specific chats for updates about topics and drafting responses
you:What are the authentication requirements?
you:How do I handle 2FA authentication?

When to choose this

Choose this server if you need to integrate Telegram functionality with AI assistants for message management and organization, especially if you're already using MCP-compatible clients like Claude Desktop or Cursor.

When NOT to choose this

Don't choose this server if you need extensive Telegram bot management features or if you have concerns about using third-party tools with your personal Telegram account due to API terms of service.

Tools this server exposes

5 tools extracted from the README
  • tg_me

    Get current account information

  • tg_dialogs

    List dialogs with optional unread filter

  • tg_read

    Mark dialog as read

  • tg_dialog

    Retrieve messages from specific dialog

  • tg_send

    Send draft messages to any dialog

Comparable tools

whatsapp-mcpdiscord-mcpsignal-mcp

Installation

Installation

**Homebrew** (macOS/Linux):

brew install chaindead/tap/telegram-mcp

**NPX** (cross-platform):

npx -y @chaindead/telegram-mcp

**From Releases**: Download the appropriate binary for your platform from [GitHub Releases](https://github.com/chaindead/telegram-mcp/releases)

**From Source**:

go install github.com/chaindead/telegram-mcp@latest

**Claude Desktop Configuration**:

{
  "mcpServers": {
    "telegram": {
      "command": "telegram-mcp",
      "env": {
        "TG_APP_ID": "<your-app-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

FAQ

What are the authentication requirements?
You need to obtain an API ID and API hash from Telegram (https://my.telegram.org/auth) and run the auth command with your phone number.
How do I handle 2FA authentication?
Add the --password flag with your 2FA password when running the auth command: telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number> --password <your-2fa-password>

Compare telegram-mcp with

telegram-mcp vs mcp-server-charttelegram-mcp vs filesystemtelegram-mcp vs timetelegram-mcp vs memorytelegram-mcp vs fetch
GitHub →

Last updated · Auto-generated from public README + GitHub signals.