Listing dialogs filtered to unread turns a scattered inbox into something summarisable in one pass, and marking read afterwards keeps the state honest. Because it authenticates as you rather than as a bot, it sees everything you see — worth reading Telegram's API terms before you point automation at it, as the project itself asks.
A Telegram bridge for AI assistants, running as your account through the Telegram API rather than as a bot.
- tg_me — your current account information
- tg_dialogs — your chat list, with an optional unread filter
- tg_dialog — messages from a specific chat
- tg_read — mark a dialog as read
- tg_send — send a draft message to any dialog
An API ID and hash from my.telegram.org, then a one-time telegram-mcp auth with your phone number and the code Telegram sends; add --password if you have 2FA. TG_APP_ID and TG_API_HASH go in the client config. Install by Homebrew, npx @chaindead/telegram-mcp, a release binary, or go install with Go 1.24 or later. Clients that reject JSON Schema Draft 2020-12, such as VS Code, can be handled with TG_SCHEMA_VERSION set to the Draft-07 URL.
One command plus a key — npx -y @chaindead/telegram-mcp, then supply credentials