MCP Telegram Server

MCP Telegram Server is an MCP server that connects AI assistants and large language models directly to the Telegram API via MTProto. Designed for developers and automated workflows, it acts as a gateway that replaces broad micro-APIs with eight context-efficient tools. It enables clients to authenticate via mobile QR codes, bot tokens, or standard credentials, facilitating direct interaction with personal accounts or bots. Users can search messages across chats, inspect threads and forum topics, download replies, and dispatch formatted text along with rich file attachments. The server supports multi-tenant remote deployments over HTTP with Bearer tokens as well as local execution via standard I/O. Through this bridge, AI agents can read user dialogues, fetch chat profiles, execute targeted queries across folders, and access raw MTProto methods when advanced interaction is necessary, all while enforcing session isolation and access control lists.

Category: Communication & Messaging

Tags: bot, chat, messaging, telegram

Visit MCP Telegram Server

How to install and configure MCP Telegram Server

1. Set up your Telegram session by running uvx --from fast-mcp-telegram fast-mcp-telegram-setup --api-id="your_api_id" --api-hash="your_api_hash" --phone-number="+123456789" (or provide BOT_API_TOKEN instead of a phone number). 2. For local stdio connections, add the server to your claude_desktop_config.json: json { "mcpServers": { "telegram": { "command": "uvx", "args": ["fast-mcp-telegram"], "env": { "API_ID": "your_api_id", "API_HASH": "your_api_hash" } } } } 3. For remote HTTP deployments, configure the endpoint and auth header instead: json { "mcpServers": { "telegram": { "url": "https://tg-mcp.l1979.ru/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } 4. Restart your MCP client to access the Telegram tools.

What you can do with MCP Telegram Server

• Search global conversations, direct messages, and group channels using complex multi-term queries and date filtering parameters. - Send formatted messages, media files, and local documents directly to individual users, chat groups, or forum topics. - Retrieve chat history, inspect thread replies, and read messages across specific dialog folders or saved message spaces. - Discover user profiles, gather contact details, and resolve channel metadata including bio information, member counts, and common groups. - Transcribe voice messages automatically using Telegram Premium capabilities and deliver text output directly to the requesting assistant.

Key facts

• https://github.com/leshchenko1979/fast-mcp-telegram
• Communication & Messaging
• bot, chat, messaging, telegram

Part of MCP Servers

What is MCP Telegram Server?

MCP Telegram Server is a Model Context Protocol gateway that connects AI assistants to the Telegram platform. It enables agents to read chats, retrieve message history, manage contacts, and send formatted text or attachments using Telegram's MTProto API.

How do I install MCP Telegram Server?

You install and authenticate using uvx by executing the fast-mcp-telegram-setup tool with your API credentials. Once your session is established, register fast-mcp-telegram under the mcpServers configuration in your client configuration file using uvx or connect via an HTTP endpoint.

What tools are included in MCP Telegram Server?

The server consolidates functionality into eight core tools: search_messages_globally, get_messages, send_message, edit_message, find_chats, get_chat_info, send_message_to_phone, and invoke_mtproto for raw API interactions.

Is MCP Telegram Server open source?

Yes, MCP Telegram Server is open source and released under the MIT license. You can inspect its source code, contribute modifications, or self-host it directly from its GitHub repository.