Telegram MCP Server

Telegram MCP for managing dialogs, messages, drafts, read statuses, and more.

Local serverstdioGo

What is the Telegram MCP Server?

Telegram MCP for managing dialogs, messages, drafts, read statuses, and more.

The short version

The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol.

The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop or Cursor, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.

  • Get current account information (tool: tg_me)
  • List dialogs with optional unread filter (tool: tg_dialogs)
  • Mark dialog as read (tool: tg_read)
  • Retrieve messages from specific dialog (tool: tg_dialog)
  • Send draft messages to any dialog (tool: tg_send)

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.

How to install the Telegram MCP Server

claude mcp add telegram-mcp-chaindead --env TG_APP_ID=your-value --env TG_API_HASH=your-value -- npx -y You

Configuration

VariableDescriptionRequired
TG_APP_IDConfiguration value read at startup.Optional
TG_API_HASHConfiguration value read at startup.Optional

Example prompts to try

  • “Use Telegram to Version.”
  • “Use Telegram to Capabilities.”
  • “Use Telegram to Organization.”

Frequently asked questions

Telegram MCP for managing dialogs, messages, drafts, read statuses, and more. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.