← Index

io.github.n24q02m/better-telegram-mcp

io.github.n24q02m/better-telegram-mcp·v4.8.5·Chat & Messaging
Quality Score
85
/100

Telegram MCP server — dual-mode Bot API + MTProto, 6 composite tools.

§01  Install
Claude Desktop (uvx)
{
  "mcpServers": {
    "better-telegram-mcp": {
      "command": "uvx",
      "args": [
        "better-telegram-mcp"
      ],
      "env": {
        "TELEGRAM_BOT_TOKEN": "<your-telegram_bot_token>",
        "TELEGRAM_API_ID": "<telegram_api_id>",
        "TELEGRAM_API_HASH": "<your-telegram_api_hash>"
      }
    }
  }
}
Claude Desktop (Docker)
{
  "mcpServers": {
    "better-telegram-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "docker.io/n24q02m/better-telegram-mcp:latest"
      ],
      "env": {
        "TELEGRAM_BOT_TOKEN": "<your-telegram_bot_token>",
        "TELEGRAM_API_ID": "<telegram_api_id>",
        "TELEGRAM_API_HASH": "<your-telegram_api_hash>"
      }
    }
  }
}
§02  Environment variables
TELEGRAM_BOT_TOKEN
secret

Telegram bot token from @BotFather (for bot mode)

TELEGRAM_API_ID

Telegram API ID from my.telegram.org (for user mode)

TELEGRAM_API_HASH
secret

Telegram API hash from my.telegram.org (for user mode)

TELEGRAM_BOT_TOKEN
secret

Telegram bot token from @BotFather (for bot mode)

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Chat & Messaging