PluginBench
MCP Server

Better Telegram MCP MCP Server

io.github.n24q02m/better-telegram-mcp

What is the Better Telegram MCP MCP server?

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

How to install Better Telegram MCP

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • 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)

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "better-telegram-mcp": {
      "command": "uvx",
      "args": [
        "better-telegram-mcp"
      ],
      "env": {
        "TELEGRAM_BOT_TOKEN": "<YOUR_TELEGRAM_BOT_TOKEN>",
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "better-telegram-mcp": {
      "command": "uvx",
      "args": [
        "better-telegram-mcp"
      ],
      "env": {
        "TELEGRAM_BOT_TOKEN": "<YOUR_TELEGRAM_BOT_TOKEN>",
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "better-telegram-mcp": {
      "command": "uvx",
      "args": [
        "better-telegram-mcp"
      ],
      "env": {
        "TELEGRAM_BOT_TOKEN": "<YOUR_TELEGRAM_BOT_TOKEN>",
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "better-telegram-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "better-telegram-mcp"
      ],
      "env": {
        "TELEGRAM_BOT_TOKEN": "<YOUR_TELEGRAM_BOT_TOKEN>",
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>"
      }
    }
  }
}
Claude Code
claude mcp add better-telegram-mcp --env TELEGRAM_BOT_TOKEN=<YOUR_TELEGRAM_BOT_TOKEN> --env TELEGRAM_API_ID=<YOUR_TELEGRAM_API_ID> --env TELEGRAM_API_HASH=<YOUR_TELEGRAM_API_HASH> -- uvx better-telegram-mcp

Related MCP servers

Knowledge graph for token-efficient code reviews with fixed search and configurable embeddings

View repository →

IMAP/SMTP MCP server for Email with composite tools. Multi-account, auto-discovery.

View repository →

MCP server for Godot Engine 4.x with 17 tools for scenes, scripts, and shaders.

View repository →

Markdown-first MCP server for Notion API with 9 composite tools and 39+ actions.

View repository →

MCP server for image/video understanding & generation (Gemini/OpenAI/Grok)

View repository →

Persistent AI memory with hybrid search (FTS5 + semantic) and cross-machine sync.

View repository →