Telegram MCP Server

Telegram MCP server for two-way bot communication with session management

Local serverstdio

What is the Telegram MCP Server?

Telegram MCP server for two-way bot communication with session management

What you get

A Model Context Protocol (MCP) server that connects Claude Code to Telegram via a bot.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
send_messageSend a text message
send_photoSend a photo (URL, file ID, or local path)
get_updatesRead incoming messages (cursor-based, session-filtered)
list_chatsList all known chats
set_sessionSet a name/emoji prefix and register a Telegram command for this session

How to install the Telegram MCP Server

{
  "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.

Configuration

VariableDescriptionRequired
TELEGRAM_BOT_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Telegram to send message.”
  • “Use Telegram to send photo.”
  • “Use Telegram to get updates.”

Frequently asked questions

Telegram MCP server for two-way bot communication with session management Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.