by chaindead
Manage Telegram dialogs, messages, drafts, and read statuses through an MCP server, enabling AI assistants to interact with Telegram seamlessly.
The server acts as a bridge between the Telegram API and AI assistants, exposing Telegram functionality (account info, dialogs, messages, drafts, read status) via the Model Context Protocol.
brew install chaindead/tap/telegram-mcp
npx -y @chaindead/telegram-mcp
PATH
.go install github.com/chaindead/telegram-mcp@latest
(requires Go 1.24+).telegram-mcp auth --app-id <API_ID> --api-hash <API_HASH> --phone <PHONE_NUMBER>
Add --password <2FA>
if 2FA is enabled, or --new
to force a new session.{
"mcpServers": {
"telegram": {
"command": "telegram-mcp",
"env": {
"TG_APP_ID": "<your-app-id>",
"TG_API_HASH": "<your-api-hash>",
"PATH": "<path_to_binary>",
"HOME": "<home_directory>"
}
}
}
}
For NPX usage, replace the command with npx -y @chaindead/telegram-mcp
as shown in the README.tg_me
).tg_dialogs
).tg_read
).tg_dialog
).tg_send
).API ID
and API HASH
from https://my.telegram.org.brew upgrade chaindead/tap/telegram-mcp
; with NPX simply rerun the command.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.
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.
tool: tg_me
)tool: tg_dialogs
)tool: tg_read
)tool: tg_dialog
)tool: tg_send
)Here are some example prompts you can use with AI assistants:
You can install a binary release on macOS/Linux using brew:
# Install
brew install chaindead/tap/telegram-mcp
# Update
brew upgrade chaindead/tap/telegram-mcp
You can run the latest version directly using npx (supports macOS, Linux, and Windows):
npx -y @chaindead/telegram-mcp
When using NPX, modify the standard commands and configuration as follows:
npx -y @chaindead/telegram-mcp auth ...
{
"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.
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:
# 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:
# 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
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:
# 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:
# 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
.zip
filetelegram-mcp.exe
to a directory in your PATHRequirements:
go install github.com/chaindead/telegram-mcp@latest
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
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.
Example of Configuring Claude Desktop to recognize the Telegram MCP server.
Open the Claude Desktop configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json
%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:
{
"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:
{
"mcpServers": {
"telegram-mcp": {
"command": "telegram-mcp",
"env": {
"TG_APP_ID": "<your-app-id>",
"TG_API_HASH": "<your-api-hash>"
}
}
}
}
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "telegram": { "command": "npx", "args": [ "-y", "@chaindead/telegram-mcp" ], "env": { "TG_APP_ID": "<YOUR_API_ID>", "TG_API_HASH": "<YOUR_API_HASH>" } } } }
Discover more MCP servers with similar functionality and use cases
by line
Enables AI agents to send, receive, and manage various LINE messages and rich menus through the LINE Messaging API.
by EnesCinr
twitter-mcp is a Model Context Protocol (MCP) server that enables interaction with Twitter, allowing users to post tweets and search for tweets programmatically.
by trypeggy
instagram_dm_mcp is a Model Context Protocol (MCP) server that enables sending Instagram Direct Messages from your account. It allows integration with large language models (LLMs) to automate Instagram messaging and other interactions.
by vidhupv
x-mcp is an MCP server that allows users to create, manage, and publish X/Twitter posts directly through Claude chat.
by ertiqah
Enables GPT‑powered assistants to tap into a user's public LinkedIn activity, allowing automatic post creation, performance analysis, and voice‑consistent rewrites directly from Claude or ChatGPT.
by metricool
mcp-metricool is a Multi-Agent Collaboration Protocol (MCP) server that integrates with Metricool's social media analytics platform, enabling AI agents to access and analyze social media metrics, campaign data, and schedule content across various networks.
by sinjab
Extracts YouTube video metadata and transcripts via an MCP server with comprehensive logging and robust error handling.
by universal-mcp
A Universal MCP server for interacting with Reddit posts, comments, and subreddits.
by netdata
Real-time, per‑second infrastructure monitoring platform that provides instant insights, auto‑discovery, edge‑based machine‑learning anomaly detection, and lightweight visualizations without requiring complex configuration.