{"id":"c61ecec1-dddf-4927-bc61-e3711ff03450","slug":"telegram","kind":"mcp","name":"Telegram","summary":"Sends, reads and searches Telegram messages through a user account session (MTProto).","owner":"chigwell","repoUrl":"https://github.com/chigwell/telegram-mcp","license":"Apache-2.0","licenseTier":"permissive","trust":"community","stars":1821,"match":null,"fewStars":false,"format":"mcp","createdAt":"2025-03-20T14:06:35.000Z","addedAt":"2026-10-13T21:54:17.194Z","logoUrl":"https://github.com/chigwell.png?size=96","linkOnly":false,"collection":null,"skillPath":null,"categories":["communication"],"tags":["telegram","messaging","chat","mtproto","account"],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":true,"reviewed":false,"syncedAt":"2026-10-13T00:00:00.000Z","sample":false,"url":"https://conduits.dev/tools/telegram","language":"Python","transports":["stdio"],"install":{},"requirements":{"env":[{"name":"TELEGRAM_API_ID","secret":true,"required":true,"description":"API ID from my.telegram.org/apps"},{"name":"TELEGRAM_API_HASH","secret":true,"required":true,"description":"API hash from my.telegram.org/apps"},{"name":"TELEGRAM_SESSION_STRING","secret":true,"required":false,"description":"Session string (or TELEGRAM_SESSION_NAME for a file session)"},{"name":"TELEGRAM_EXPOSED_TOOLS","secret":false,"required":false,"description":"Set to read-only to expose only read tools"}],"system":["Git and uv (install from a clone)"],"service":"Telegram","upstreamMayCharge":false},"tools":[{"name":"send_message","description":"Send a message"},{"name":"get_history","description":"Read chat history"},{"name":"search_messages","description":"Search messages"},{"name":"list_chats","description":"List chats"},{"name":"send_file","description":"Send a file"},{"name":"wait_for_new_message","description":"Wait for an incoming message"}],"readme":"# Telegram\n\nSends, reads and searches Telegram messages through a user account session (MTProto).\n\n## Configuration\n\n| Variable | Required | Description |\n| --- | --- | --- |\n| `TELEGRAM_API_ID` | Yes | API ID from my.telegram.org/apps |\n| `TELEGRAM_API_HASH` | Yes | API hash from my.telegram.org/apps |\n| `TELEGRAM_SESSION_STRING` | No | Session string (or TELEGRAM_SESSION_NAME for a file session) |\n| `TELEGRAM_EXPOSED_TOOLS` | No | Set to read-only to expose only read tools |\n\n## Tools\n\n- `send_message` — Send a message\n- `get_history` — Read chat history\n- `search_messages` — Search messages\n- `list_chats` — List chats\n- `send_file` — Send a file\n- `wait_for_new_message` — Wait for an incoming message\n\n## About this listing\n\nDetails were gathered from the project's public pages on 2026-10-13 and have not been reviewed by a person yet. Read the project's own documentation before giving it access to anything sensitive.\n\nSources:\n\n- <https://github.com/chigwell/telegram-mcp>\n- <https://pypi.org/pypi/telegram-mcp/json>"}