Telegram MCP Server

@kdoronin

Repository

Basic information

About Telegram MCP Server

No overview available yet

#telegram #mcp #api-integration

Telegram MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Telegram": {
      "command": "node",
      "args": [
        "/Users/dka/Documents/Solo/git/telegram_mcp/mcp-server.js"
      ]
    }
  }
}

Telegram MCP Server tools

Gets a list of user dialogs (chats).

Gets messages from the specified chat.

Sends a message to the specified chat.

Executes an arbitrary Telegram API method (use with caution).

Overview

What is Telegram?

Telegram is an MCP (Model Context Protocol) server that enables AI agents and other MCP clients to interact with the Telegram messaging platform. It provides a bridge between the Telegram API and MCP-compatible tools, allowing automated reading of dialogs and messages, sending messages, and executing arbitrary Telegram methods using a user’s Telegram account.

How to use Telegram?

To use Telegram, clone the repository, install dependencies with npm install, create a .env file with your API_ID and API_HASH from my.telegram.org, and run the server with npm run mcp or node mcp-server.js. The server can then be configured in MCP clients such as Cursor or Claude Desktop by pointing to the server’s command (e.g., node /full/path/to/project/mcp-server.js). On first use, the server prompts for a phone number and a confirmation code (and a 2FA password if enabled).

Key features of Telegram

Reads dialogs and messages from your Telegram account.
Sends messages to any chat or user.
Executes arbitrary Telegram API methods via executeMethod.
Saves authenticated sessions locally for reuse.
Supports two-factor authentication (2FA).
Integrates easily with MCP clients like Cursor and Claude Desktop.

Use cases of Telegram

An AI assistant fetching recent chats and sending replies on a user’s behalf.
Automated message broadcasting to a Telegram channel or group.
Retrieving message history for analysis or logging.
Executing custom Telegram API calls to manage contacts, groups, or bots.
Building conversational agents that operate through Telegram.

Frequently asked questions

What are the requirements to run Telegram?

You need Node.js 14+ (or higher), npm, a Telegram API ID and API Hash obtained from [my.telegram.org](https://my.telegram.org), and a Telegram account for authentication.

How are sessions stored?

Sessions are saved as JSON files inside the `sessions/` directory, named after the phone number (e.g., `+79001234567.json`). Each file contains an encrypted authorization token and a timestamp.

What happens during first-time authorization?

The server asks for the phone number, then a confirmation code sent by Telegram. If two-factor authentication is enabled, the password is requested (up to 3 retries). Successful authorization saves the session for future use.

Can I use arbitrary Telegram API methods?

Yes, the `executeMethod` tool allows executing any Telegram API method. Use it with caution as it can perform destructive actions.

What authentication does Telegram support?

The server uses the user’s phone number and confirmation code for initial auth, and supports two-factor authentication (2FA) passwords when enabled. Multi‑session handling is supported via the `session` parameter (the phone number).

Comments

More Communication MCP servers

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

Caulo

Patry

Caulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au

JooVoice

Give your AI agent a phone. JooVoice makes real calls for you in 80+ languages, with local accents, across 67 countries, like booking a table, moving an appointment or chasing a refund, and sends back what happened. Call

2pr.io

Write, schedule and publish LinkedIn posts in your own voice, reply to comments and read your analytics, all from your AI assistant. Remote MCP server with OAuth sign-in.

Faxer

1771 Co

Send real faxes to any US, Canadian, or international fax number from any AI assistant. The agent quotes the exact price from the document's real page count, hands the human a Stripe Checkout link (payment stays human-in