MCPs
Telegram MCP Server

Telegram MCP Server

A bridge connecting AI assistants to the Telegram API via the Model Context Protocol.

View on GitHub

237

Stars

Forks

237

Watchers

Issues

Telegram MCP Server facilitates secure and structured interaction between AI assistants and the Telegram API by implementing the Model Context Protocol. It enables AI-powered tools to access, organize, and manage Telegram messages, chats, and user data while maintaining user control and privacy. The server offers capabilities for retrieving messages, managing conversations, sending drafts, and organizing chats, making it a versatile tool for AI integrations with Telegram.

Key Features

Supports retrieval of Telegram account information

Lists and filters Telegram chats with unread message options

Marks dialogs as read programmatically

Fetches messages from specific Telegram conversations

Sends draft messages to any Telegram chat

Homebrew and NPX installation options for cross-platform support

Customizable environment variables for secure configuration

Prompt-based interaction for workflow automation

Compliant with Telegram API Terms of Service

Seamless integration with AI assistants like Claude and Cursor

Use Cases

AI-driven summarization of unread Telegram messages

Automated response drafting for Telegram chats

Organizing and categorizing Telegram conversations by importance

Monitoring specific chats for important updates via AI workflows

Efficiently listing, searching, and filtering dialogs for user prioritization

Analyzing conversations to suggest folder structures or categories

Identifying and surfacing unanswered questions in messages

Bridging AI productivity tools with user messaging data

Supporting multi-platform deployments for personal or team workflows

Facilitating secure, user-controlled access to messaging information for automation

README

Telegram MCP server

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

[!IMPORTANT] Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account.

What is MCP?
What does this server do?
- Capabilities
- Prompt examples
Installation
- Homebrew
- NPX
- From Releases
  - MacOS
  - Linux
  - Windows
- From Source
Configuration
- Authorization
- Client Configuration
Star History

What is MCP?

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.

What does this server do?

Capabilities

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)

Prompt examples

Here are some example prompts you can use with AI assistants:

Message Management

"Check for any unread important messages in my Telegram"
"Summarize all my unread Telegram messages"
"Read and analyze my unread messages, prepare draft responses where needed"
"Check non-critical unread messages and give me a brief overview"

Organization

"Analyze my Telegram dialogs and suggest a folder structure"
"Help me categorize my Telegram chats by importance"
"Find all work-related conversations and suggest how to organize them"

Communication

"Monitor specific chat for updates about [topic]"
"Draft a polite response to the last message in [chat]"
"Check if there are any unanswered questions in my chats"

Installation

Homebrew

You can install a binary release on macOS/Linux using brew:

bash

# Install
brew install chaindead/tap/telegram-mcp

# Update
brew upgrade chaindead/tap/telegram-mcp

NPX

You can run the latest version directly using npx (supports macOS, Linux, and Windows):

bash

npx -y @chaindead/telegram-mcp

When using NPX, modify the standard commands and configuration as follows:

Authentication command becomes:

bash

npx -y @chaindead/telegram-mcp auth ...

Claude MCP server configuration becomes:

json

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@chaindead/telegram-mcp"],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

For complete setup instructions, see Authorization and Client Configuration.

From Releases

MacOS

Note: The commands below install to /usr/local/bin. To install elsewhere, replace /usr/local/bin with your preferred directory in your PATH.

First, download the archive for your architecture:

bash

# For Intel Mac (x86_64)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_x86_64.tar.gz

# For Apple Silicon (M1/M2)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_arm64.tar.gz

Then install the binary:

bash

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Linux

Note: The commands below install to /usr/local/bin. To install elsewhere, replace /usr/local/bin with your preferred directory in your PATH.

First, download the archive for your architecture:

bash

# For x86_64 (64-bit)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_x86_64.tar.gz

# For ARM64
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_arm64.tar.gz

Then install the binary:

bash

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Windows

Download the latest release for your architecture:
- Windows x64
- Windows ARM64
Extract the .zip file
Add the extracted directory to your PATH or move telegram-mcp.exe to a directory in your PATH

From Source

Requirements:

Go 1.24 or later
GOBIN in PATH

bash

go install github.com/chaindead/telegram-mcp@latest

Configuration

Authorization

Before you can use the server, you need to connect to the Telegram API.

Get the API ID and hash from Telegram API
Run the following command:

Note: If you have 2FA enabled: add --password <2fa_password>

Note: If you want to override existing session: add --new
bash
```
telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>
```
📩 Enter the code you received from Telegram to connect to the API.
Done! Please give this project a ⭐️ to support its development.

Client Configuration

Example of Configuring Claude Desktop to recognize the Telegram MCP server.

Open the Claude Desktop configuration file:
- in MacOS, the configuration file is located at ~/Library/Application Support/Claude/claude_desktop_config.json
- in Windows, the configuration file is located at %APPDATA%\Claude\claude_desktop_config.json
Note: You can also find claude_desktop_config.json inside the settings of Claude Desktop app

Add the server configuration

for Claude desktop:

json

 {
   "mcpServers": {
     "telegram": {
       "command": "telegram-mcp",
       "env": {
         "TG_APP_ID": "<your-app-id>",
         "TG_API_HASH": "<your-api-hash>",
         "PATH": "<path_to_telegram-mcp_binary_dir>",
         "HOME": "<path_to_your_home_directory"
       }
     }
   }
 }

for Cursor:

json

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "env": {
        "TG_APP_ID": "<your-app-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

Star History

Repository Owner

chaindead

User

Repository Details

Language Go

Default Branch main

Size 83 KB

Contributors 2

License MIT License

MCP Verified Nov 11, 2025

Programming Languages

100%

Topics

mcp mcp-server mtproto telegram telegram-api

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

Related MCPs

Discover similar Model Context Protocol servers

Telegram MCP Server

Full-featured Telegram integration for MCP-compatible clients using Telethon.

Telegram MCP Server enables programmatic interaction with Telegram through the Model Context Protocol (MCP). It allows automation of messaging, chat and group management, and other essential Telegram operations by exposing an extensive suite of tools via MCP. Designed for seamless integration with platforms like Claude and Cursor, the server is powered by Telethon and supports context-aware interactions with Telegram accounts.

⭐ 448
MCP
chigwell/telegram-mcp

Kanboard MCP Server

MCP server for seamless AI integration with Kanboard project management.

Kanboard MCP Server is a Go-based server implementing the Model Context Protocol (MCP) for integrating AI assistants with the Kanboard project management system. It enables users to manage projects, tasks, users, and workflows in Kanboard directly via natural language commands through compatible AI tools. With built-in support for secure authentication and high performance, it facilitates streamlined project operations between Kanboard and AI-powered clients like Cursor or Claude Desktop. The server is configurable and designed for compatibility with MCP standards.

⭐ 15
MCP
bivex/kanboard-mcp

TeslaMate MCP Server

Query your TeslaMate data using the Model Context Protocol

TeslaMate MCP Server implements the Model Context Protocol to enable AI assistants and clients to securely access and query Tesla vehicle data, statistics, and analytics from a TeslaMate PostgreSQL database. The server exposes a suite of tools for retrieving vehicle status, driving history, charging sessions, battery health, and more using standardized MCP endpoints. It supports local and Docker deployments, includes bearer token authentication, and is intended for integration with MCP-compatible AI systems like Claude Desktop.

⭐ 106
MCP
cobanov/teslamate-mcp

Weblate MCP Server

Seamlessly connect AI assistants to Weblate for translation management via the Model Context Protocol.

Weblate MCP Server enables AI assistants and clients to directly manage Weblate translation projects through the Model Context Protocol (MCP). It integrates with the Weblate REST API, allowing natural language interaction for project and translation management. The tool offers multiple transport options including HTTP, SSE, and STDIO, and is optimized for large language model workflows. Full support for project, component, and translation operations is provided, with a focus on type safety and flexible environment configuration.

⭐ 9
MCP
mmntm/weblate-mcp

CipherTrust Manager MCP Server

Enables AI assistants to access CipherTrust Manager securely via the Model Context Protocol.

CipherTrust Manager MCP Server provides an implementation of the Model Context Protocol (MCP), offering AI assistants such as Claude and Cursor a unified interface to interact with CipherTrust Manager resources. Communication is facilitated through JSON-RPC over stdin/stdout, enabling key management, CTE client management, user management, and connection management functionalities. The tool is configurable via environment variables and integrates with existing CipherTrust Manager instances using the ksctl CLI for secure resource access.

⭐ 7
MCP
sanyambassi/ciphertrust-manager-mcp-server

mcp-get

A command-line tool for discovering, installing, and managing Model Context Protocol servers.

mcp-get is a CLI tool designed to help users discover, install, and manage Model Context Protocol (MCP) servers. It enables seamless integration of Large Language Models (LLMs) with various external data sources and tools by utilizing a standardized protocol. The tool provides access to a curated registry of MCP servers and supports installation and management across multiple programming languages and environments. Although now archived, mcp-get simplifies environment variable management, package versioning, and server updates to enhance the LLM ecosystem.

⭐ 497
MCP
michaellatman/mcp-get

View all Alternatives

Didn't find tool you were looking for?

Search AI Tools

Telegram MCP Server

Key Features

Use Cases

README

Telegram MCP server

Table of Contents

What is MCP?

What does this server do?

Capabilities

Prompt examples

Message Management

Organization

Communication

Installation

Homebrew

NPX

From Releases

MacOS

Linux

Windows

Windows

From Source

Configuration

Authorization

Client Configuration

Star History

Star History

Repository Owner

Repository Details

Programming Languages

Tags

Topics

Related MCPs