telegram-mcp
Level ALocalTelegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.
Overview
A Telegram MCP server built on Telethon that connects Claude, Cursor, and other MCP clients to Telegram accounts. It offers 80+ tools for reading chats, managing groups and channels, sending and editing messages, handling media, contacts, and folders, with multi-account routing, chat allowlists, and contact aliases.
Installation
MCP client config (paste into mcp.json)
{
"mcpServers": {
"chigwell-telegram-mcp": {
"command": "uv",
"args": [
"--directory",
"/full/path/to/telegram-mcp",
"run",
"main.py"
],
"env": {
"TELEGRAM_API_ID": "your_api_id_here",
"TELEGRAM_API_HASH": "your_api_hash_here",
"TELEGRAM_SESSION_STRING": "your_session_string_here"
}
}
}
}Agent install prompt
Copy and paste into Cursor / Claude / other agents to install this MCP for you
Please read this MCP repository and install it into my current environment:
https://github.com/chigwell/telegram-mcp
Known working client config (can write into mcp.json):
{
"mcpServers": {
"chigwell-telegram-mcp": {
"command": "uv",
"args": [
"--directory",
"/full/path/to/telegram-mcp",
"run",
"main.py"
],
"env": {
"TELEGRAM_API_ID": "your_api_id_here",
"TELEGRAM_API_HASH": "your_api_hash_here",
"TELEGRAM_SESSION_STRING": "your_session_string_here"
}
}
}
}
Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.
Related servers
worldmonitorReal-time global intelligence dashboard. AI-powered news aggregation, geopoliticdeer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creatruflo🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinateheadroomCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20mem0The Memory Layer for AI Agents - Drop-in memory infrastructure for AI agents andlitellmThe fastest, litest AI Gateway. Rust core with Python SDK. Call 100+ LLM APIs in