This MCP server is feature-rich, offering 80+ tools covering Telegram messaging, groups, media, contacts, and admin functions. It requires a user-level session string, so permissions are broad; users should store credentials carefully. The project includes security measures (e.g., read-only mode, path restrictions, prompt injection protections), but risks remain. Installation must be done via cloning or Git install to avoid the PyPI package of the same name.
telegram-mcp is a Model Context Protocol (MCP) server built on Telethon that provides full Telegram integration for MCP-compatible clients like Claude, Cursor, and Codex. It exposes 80+ tools for managing Telegram accounts, chats, messages, contacts, media, folders, and admin operations. Supports stdio, HTTP, and SSE transports, multi-account setups, proxy support, contact alias memory, read-only mode, file path security, Docker deployment, and prompt injection protections.
git clone https://github.com/chigwell/telegram-mcp.git && cd telegram-mcp && uv sync.uv run session_string_generator.py --qr (recommended) or --phone.uv run main.py, or configure your MCP client with uv --directory /path/to/telegram-mcp run main.py and the environment variables.{
"mcpServers": {
"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"
}
}
}
}