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:
Local install
STDIO
No auth required
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.
Local install — runs as a subprocess.
Configuration this server reads at startup.
Telegram bot token from @BotFather (for bot mode)
Telegram API ID from my.telegram.org (for user mode)
Telegram API hash from my.telegram.org (for user mode)
Telegram bot token from @BotFather (for bot mode)
Where to find authoritative docs and source for N24q02m Better Telegram.
Paste any of these into Agent Studio after connecting N24q02m Better Telegram.
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.
MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 60+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.
Open Agent StudioIn 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
Judges Panel
45 judges that evaluate AI-generated code for security, cost, and quality with built-in AST.
Addozhang Nexus
Query Sonatype Nexus Repository (OSS/Pro) for Maven, Python, and Docker artifacts
Cyanheads MCP Ts Template
TypeScript template for building MCP servers with declarative tooling, observability, and auth.
Chernistry Bernstein
Declarative agent orchestration for engineering teams