Better Telegram Mcp
by n24q02mcommunityv4.11.0
5
4
This MCP server for Telegram supports dual-mode operation, allowing quick bot integrations via the Bot API and full user-account access through MTProto.
From the registry: Telegram MCP server — dual-mode Bot API + MTProto, 6 composite tools.
Install & configure
Prerequisites
- requiredTelegram credentialsEither a bot token (Bot API mode) from @BotFather, or api_id/api_hash from my.telegram.org (MTProto user mode).https://core.telegram.org
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `better-telegram-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Telegram credentials** — Either a bot token (Bot API mode) from @BotFather, or api_id/api_hash from my.telegram.org (MTProto user mode). (https://core.telegram.org)
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["better-telegram-mcp"]
- optional environment variables:
- `TELEGRAM_BOT_TOKEN`: Telegram Bot API token (Bot mode). Set this OR API_ID/API_HASH. (example: `<your-bot-token>`)
- `TELEGRAM_API_ID`: Telegram API ID for MTProto user mode (example: `<your-telegram-api-id>`)
- `TELEGRAM_API_HASH`: Telegram API hash for MTProto user mode (example: `<your-telegram-api-hash>`)
Note: README points to docs/setup-manual.md for detailed env; Bot-API mode needs TELEGRAM_BOT_TOKEN, user MTProto mode needs API_ID + API_HASH and a web-based OTP auth flow.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: README points to docs/setup-manual.md for detailed env; Bot-API mode needs TELEGRAM_BOT_TOKEN, user MTProto mode needs API_ID + API_HASH and a web-based OTP auth flow.
Tools (6)
message
Send, edit, delete, forward messages, and manage message interactions.
chat
List and manage chats, groups, channels, and their members.
media
Send and download various media types including photos and videos.
contact
Manage contacts by listing, searching, adding, and blocking users.
config
Manage server status and runtime settings.
help
Provides full documentation for any topic.
Packages
better-telegram-mcp
pypiv4.11.0transport: stdio
docker.io/n24q02m/better-telegram-mcp:latest
ocitransport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- May 9, 2026
- Last commit
- May 18, 2026
- Registry name
- io.github.n24q02m/better-telegram-mcp