Telegram MCP server for two-way bot communication with session management
Telegram MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Telegram MCP server for two-way bot communication with session management.
A Model Context Protocol (MCP) server that connects Claude Code to Telegram via a bot.
Once Telegram is connected, these are the calls the assistant has available:
send_message — Send a text messagesend_photo — Send a photo (URL, file ID, or local path)get_updates — Read incoming messages (cursor-based, session-filtered)list_chats — List all known chatsset_session — Set a name/emoji prefix and register a Telegram command for this sessiontelegram-mcp-bot on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.
You will need one environment variable: TELEGRAM_BOT_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Among the team communication options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Telegram's toolset — send_message, send_photo, get_updates and 2 more — is a fair guide to whether it matches your workflow. It is maintained by hatipaksunger; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| send_message | Send a text message |
| send_photo | Send a photo (URL, file ID, or local path) |
| get_updates | Read incoming messages (cursor-based, session-filtered) |
| list_chats | List all known chats |
| set_session | Set a name/emoji prefix and register a Telegram command for this session |
{
"mcpServers": {
"telegram-1": {
"command": "npx",
"args": ["-y", "telegram-mcp-bot"],
"env": {
"TELEGRAM_BOT_TOKEN": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| TELEGRAM_BOT_TOKEN | Credential the server authenticates with. | Yes |
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Inbox intelligence — search, read, draft and send Gmail through your assistant with OAuth auto-setup.
Read and write Jira, Confluence, Bitbucket, JSM and Compass from your AI client — with your own permissions.
Read and send Telegram messages through your assistant — chats, channels and history via the client API.
Enables Discord bot integration with Model Context Protocol (MCP) compatible applications like Claude Desktop.
Exposes REST APIs defined by OpenAPI specifications as Model Context Protocol (MCP) tools, facilitating seamless integration into MCP-based workflows.