mcp-telegram
MCP Telegram is a server that enables Large Language Models to control Telegram via the Model Context Protocol. It is built using Telethon and allows AI agents to perform actions such as sending and managing messages, searching chats, and handling media on Telegram.
What are the prerequisites for using MCP Telegram?
You need Python 3.10 or higher and the 'uv' tool installed.
How do I authenticate with my Telegram account?
Use the 'mcp-telegram login' command and provide your API ID, API Hash, phone number, verification code, and 2FA password if enabled.
How can I troubleshoot database locked errors?
Ensure only one instance of 'mcp-telegram' uses a session file at a time. Use 'pkill -f "mcp-telegram"' on macOS/Linux or 'taskkill /F /IM mcp-telegram.exe /T' on Windows to stop stuck processes.
How do I connect MCP Telegram to MCP clients?
Configure the MCP server in the client's configuration file with the command, args, and environment variables for API ID and API Hash.
What should I do if my client cannot execute 'mcp-telegram'?
Use the full path to the executable in the configuration file. Find the path using 'which mcp-telegram' on macOS/Linux or 'where mcp-telegram' on Windows.