Better Telegram MCP

local MCP server

Installation

Terminal

claude mcp add better-telegram-mcp -e TELEGRAM_BOT_TOKEN=... -e TELEGRAM_API_ID=... -e TELEGRAM_API_HASH=... -- uvx better-telegram-mcp

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "better-telegram-mcp": {
      "command": "uvx",
      "args": [
        "better-telegram-mcp"
      ],
      "env": {
        "TELEGRAM_BOT_TOKEN": "...",
        "TELEGRAM_API_ID": "...",
        "TELEGRAM_API_HASH": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

Summary

Telegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.

Questions

Better Telegram MCP is a local MCP server distributed as the pypi package better-telegram-mcp.

Run: claude mcp add better-telegram-mcp -e TELEGRAM_BOT_TOKEN=... -e TELEGRAM_API_ID=... -e TELEGRAM_API_HASH=... -- uvx better-telegram-mcp

Run: codex mcp add better-telegram-mcp --env TELEGRAM_BOT_TOKEN=... --env TELEGRAM_API_ID=... --env TELEGRAM_API_HASH=... -- uvx better-telegram-mcp

Similar MCP servers

NameStars

WhatsApp Web MCP Serverio.github.mario-andreschak/mcp-whatsapp-web26
Chatroost — unofficial Telegram MCP serverio.github.mcp-telegram/mcp-telegram43
mcp-ssh-managerio.github.bvisible/mcp-ssh-manager493
mcp-whatsapp-cloudio.github.codespar/mcp-whatsapp-cloud271
mcp-z-apiio.github.codespar/mcp-z-api271
Google Workspaceio.github.aaronsb/google-workspace189
x-useio.github.ihuzaifashoukat/x-use168
AgentPhoneio.github.AgentPhone-AI/agentphone124