MCP Telegram MCP Server

Telegram MCP server (MTProto). Connect Claude, Cursor, Claude Code, VS Code, Codex, Cline, Windsurf to a real Telegram account — read/search/send

Remote serverstreamable-http

What is the MCP Telegram MCP Server?

Telegram MCP server (MTProto). Connect Claude, Cursor, Claude Code, VS Code, Codex, Cline, Windsurf to a real Telegram account — read/search/send messages, moderate

What it actually does

Telegram MCP server for Claude, Codex, Cursor, Claude Code, VS Code, Cline, Windsurf, and other MCP clients. Real Telegram user account via MTProto, browser-based local sign-in, 100+ tools. Need lazy-loading + lower context cost? See telegram-agent, the skill-based companion.

Configuration

  1. Node.js >=20 2. Telegram API credentials from my.telegram.org/apps — api_id and api_hash

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
loginOpen the browser-based sign-in flow. Adds an account.
list_accountsList signed-in accounts.
list_dialogsList dialogs/chats/channels. Filters: unread, archived, ignorePinned, folder, limit.
list_messagesList messages in a dialog. Newest first.
search_messagesSearch inside one dialog: query, filter (photos/videos/url/voice/...), fromUser, date range.
search_globalSearch across every chat you have.
search_dialogsFind dialogs by name/title/username substring.
send_messageSend text. Supports replyTo, topMsgId, parseMode, schedule, silent.
send_fileSend a file (local path or https:// URL). Pass an array for an album.
download_mediaSave the media on a message to disk.
transcribe_messageTranscribe a voice/video note (Premium).
invoke_mtprotoCall any raw MTProto method by name. Auto-resolves peer/channel/user strings.
logoutDrop a local session and revoke it on Telegram.
open_settingsOpen the local settings page (tool surface + read-only).

Configuration

  1. Node.js >=20 2. Telegram API credentials from my.telegram.org/apps — api_id and api_hash
VariableDescriptionRequired
TELEGRAM_API_IDConfiguration value read at startup.Optional
TELEGRAM_API_HASHConfiguration value read at startup.Optional

Example prompts to try

  • “Use MCP Telegram to login.”
  • “Use MCP Telegram to list accounts.”
  • “Use MCP Telegram to list dialogs.”

Frequently asked questions

Node.js version 20 or later and Telegram API credentials (`api_id` and `api_hash`) from [my.telegram.org/apps](https://my.telegram.org/apps). Both environment variables are required.