PluginBench
MCP Server
Active
Apache-2.0

Telegram MCP Server MCP Server

io.github.tolboy/telegram-mcp-tdlib

RepositoryRegistry
How to choose

What this kind of tool is for

  • Draft, send, or triage messages and email from inside your agent.
  • Pipe notifications from a build or alert into your team channel automatically.
  • Summarize a busy channel thread into the handful of points that matter.

How to compare servers like this

Channel coverage:
Check the specific app (email, chat, notifications) and whether it reads as well as writes.
Scope of access:
Messages are sensitive; review what the tool can see before connecting an account.
Rate behavior:
Bulk-sending tools should respect provider limits — avoid anything that floods.
Maintenance signal:
APIs in this space change often; recent updates are a strong signal.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the Telegram MCP Server MCP server?

Local-first TDLib Telegram MCP server with 115 tools, account isolation and production guardrails.

How to install Telegram MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • TDLIB_API_ID
    required

    Telegram API ID from my.telegram.org

  • TDLIB_API_HASH
    required
    secret

    Telegram API hash from my.telegram.org

  • TDLIB_PHONE_NUMBER
    secret

    Telegram phone number; omit after preparing a persisted session when using QR authentication

  • TDLIB_AUTH_CODE
    secret

    One-time Telegram login code for a fresh headless container

  • TDLIB_2FA_PASSWORD
    secret

    Telegram 2FA password when the account requires it

  • MCP_READ_ONLY

    Keep true for safe first use

  • MCP_TOOL_PROFILE

    Tool surface: reader, inbox, community-admin, research, or all

~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "telegram-mcp-tdlib": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tolboy/telegram-mcp-tdlib:1.17.0-stdio"
      ],
      "env": {
        "TDLIB_API_ID": "<YOUR_TDLIB_API_ID>",
        "TDLIB_API_HASH": "<YOUR_TDLIB_API_HASH>",
        "TDLIB_PHONE_NUMBER": "<YOUR_TDLIB_PHONE_NUMBER>",
        "TDLIB_AUTH_CODE": "<YOUR_TDLIB_AUTH_CODE>",
        "TDLIB_2FA_PASSWORD": "<YOUR_TDLIB_2FA_PASSWORD>",
        "MCP_READ_ONLY": "<YOUR_MCP_READ_ONLY>",
        "MCP_TOOL_PROFILE": "<YOUR_MCP_TOOL_PROFILE>"
      }
    }
  }
}

Related MCP servers

The first bar for AI. Visit, chat with SERVO the bartender, and tip in tokens.

1
JavaScript
View repository →
COCourier logo

Courier

Maintained

Send notifications, manage templates, and configure integrations with Courier.

2
TypeScript
MIT
View repository →

Send and manage WhatsApp messages, contacts, templates, and events via Peach AI.

0
TypeScript
MIT
View repository →

Drive the Cursor agent from Telegram, Discord, or GitHub — with images and voice notes.

2
TypeScript
MIT
View repository →

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

View repository →
TOToleno Network logo

Toleno Network

Maintained

Manage your Toleno mining account from Claude AI using natural language commands.

186
JavaScript
View repository →