~/products/telegram-mcp/README.md
Telegram MCP
MCP-сервер, который даёт ИИ-агенту доступ к вашему личному Telegram: найти чат, прочитать и поискать переписку, отправить сообщение — когда вы прямо об этом попросили.
- Версия
- 1.0
- Клиенты
- Claude Code, Codex и другие MCP
- Нужно
- Node.js 22 и аккаунт Telegram
- Лицензия
- MIT
Зачем
Без него агент добирается до Telegram через браузер, Telegram Web, CDP или файлы десктопного клиента. Это хрупко и даёт агенту больше, чем нужно. Telegram MCP — один узкий вход: отдельная сессия, десять инструментов и подтверждение на каждое действие, которое что-то меняет.
Что умеет
- Чаты — последние диалоги, поиск по имени и @username, архив.
- История — сообщения чата постранично. Чат не помечается прочитанным.
- Поиск — по всем чатам сразу или внутри одного.
- Вложения — фото и документы из сообщений сохраняются локально.
- Отправка — текст или файл, только с
confirm: true, можно ответом на сообщение. - Вход — код из Telegram и облачный пароль, из терминала или прямо из агента.
Как это выглядит
Claude Code + Telegram MCP
- выЧто мне вчера писали в рабочем чате про релиз?
- агентlist_dialogs {"query": "рабочий"}
- агентsearch_messages {"peer": "title:Рабочий", "query": "релиз"}
- агентТри сообщения, последнее — перенос на пятницу.
- выОтветь: «Ок, в пятницу успеваю».
- агентsend_message {"peer": "title:Рабочий", "text": "Ок, в пятницу успеваю", "confirm": true}
Совместимость
Работает с любым клиентом, который запускает MCP-серверы через stdio. Я подключаю его к Claude Code и Codex; для Cursor, Claude Desktop и других клиентов схема та же — командаnode server.mjs.
Статус
Версия 1.0 — рабочий инструмент, которым я пользуюсь сам. Исходный код открыт под лицензией MIT: github.com/vixkosla/telegram-mcp.