MCP ServerSTDIOOfficialv4.10.0

N24q02m Better Telegram MCP Server

Send and receive Telegram messages programmatically via bot or user account. Developers can automate Telegram workflows—notifications, alerts, chat monitoring—using either the Bot API or MTProto protocol.

io.github.n24q02m/better-telegram-mcp

N24q02m Better Telegram runs locally over stdio. Test it on your machine with MCP Playground Desktop:

Hosted URL

Local install

Transport

STDIO

Auth

No auth required

What the N24q02m Better Telegram MCP server does

How models use it and what it is built for.

Send and receive Telegram messages programmatically via bot or user account. Developers can automate Telegram workflows—notifications, alerts, chat monitoring—using either the Bot API or MTProto protocol.

Connect to N24q02m Better Telegram

Local install — runs as a subprocess.

uvx better-telegram-mcp==4.10.0

Environment variables

Configuration this server reads at startup.

  • TELEGRAM_BOT_TOKENSecret

    Telegram bot token from @BotFather (for bot mode)

  • TELEGRAM_API_ID

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

  • TELEGRAM_API_HASHSecret

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

  • TELEGRAM_BOT_TOKENSecret

    Telegram bot token from @BotFather (for bot mode)

Resources

Where to find authoritative docs and source for N24q02m Better Telegram.

Example prompts for N24q02m Better Telegram

Paste any of these into Agent Studio after connecting N24q02m Better Telegram.

  • Send a message to chat ID 123456789 with text hello world
  • Fetch recent messages from a Telegram channel I'm a member of
  • Set up a bot to listen for incoming messages and log them
  • What's the difference between Bot API mode and MTProto mode in this server

N24q02m Better Telegram MCP server — FAQ

Common questions about connecting and running N24q02m Better Telegram.

  • Do I need a Telegram bot token or user credentials?

    You need either a bot token (from @BotFather) for bot mode, or API ID + API hash (from my.telegram.org) for user/MTProto mode. The server supports both; choose based on your use case.

  • What's the difference between Bot API and MTProto modes?

    Bot API mode uses Telegram's official bot interface (simpler, more limited). MTProto mode uses the user client protocol (more powerful, requires user credentials). The registry mentions 'dual-mode' support.

  • Can I use this to monitor or forward messages from private chats?

    MTProto mode allows deeper access to user accounts and channels. Bot mode is restricted to chats where the bot is explicitly added. Check Telegram's terms of service for your use case.

  • How do I install and run this MCP server?

    Run `uvx better-telegram-mcp@4.10.0` and set the required environment variables (TELEGRAM_BOT_TOKEN or TELEGRAM_API_ID + TELEGRAM_API_HASH). It communicates via stdio.

  • What are the 6 composite tools mentioned in the registry?

    The registry lists 'dual-mode Bot API + MTProto, 6 composite tools' but doesn't detail them. Check the project repository or documentation for the full list of available tools.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 90+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio

In your browser

MCP Agent Studio

Server has a public URL? Chat with 90+ models on it, watch every tool call, and compare models side by side.

Open MCP Agent Studio →

On your computer

MCP Playground Desktop

Server runs on localhost or over stdio? The browser can’t reach it. The desktop app can, with 90+ models in Agent Studio. Download free

Related servers

More on MCP Playground