Labsco
MCP SERVER

MCP Telegram

by overpod ↗

Your own Telegram account in an MCP client — 181 tools across messaging, groups, stories, polls and business features.

Team Chat Platforms
Summary
This is your account, not a bot — the reach is the point and the risk.

Signing in as a user is what makes global search across every chat, story publishing and admin actions possible; a bot token cannot do any of it. That also means the session file is as good as your Telegram login, and the tool list includes banning members and terminating sessions. The env-gated groups are a sensible response: Stars and group calls stay absent until you deliberately enable them.

What it is

An MCP server that signs into Telegram as you (QR login, not a bot token) and exposes 181 auto-discoverable tools across the client API — reading and sending messages, moderating groups, stories, polls, stickers, folders, privacy and Telegram Business.

What you get
  • Messaging — `telegram-send-message`, `telegram-edit-message`, `telegram-delete-message`, `telegram-forward-message`, `telegram-send-scheduled`, `telegram-translate-message`, `telegram-get-message-link`
  • Reading — `telegram-list-chats`, `telegram-read-messages`, `telegram-search-messages` in one chat, `telegram-search-global` across all of them, `telegram-get-unread`, `telegram-get-unread-mentions`, `telegram-get-replies`
  • Groups and moderation — `telegram-create-group`, `telegram-invite-to-group`, `telegram-kick-user`, `telegram-ban-user`, `telegram-set-admin`, `telegram-set-chat-permissions`, `telegram-set-slow-mode`, `telegram-get-admin-log`
  • Media — `telegram-send-file`, `telegram-download-media`, `telegram-send-voice`, `telegram-send-video-note`, `telegram-send-album`, `telegram-send-location`, `telegram-send-contact`; all `filePath` arguments must be absolute local paths, with URLs, path traversal and `/proc`-style pseudo-filesystems rejected
  • Stories, polls and reactions — `telegram-send-story`, `telegram-get-story-views`, `telegram-create-poll`, `telegram-vote-poll`, `telegram-get-poll-results`, `telegram-send-reaction`, `telegram-send-paid-reaction`
  • Account and organisation — `telegram-get-sessions`, `telegram-terminate-session`, `telegram-set-privacy`, `telegram-create-folder`, `telegram-mute-chat`, `telegram-archive-chat`, `telegram-pin-message`
  • Some tools stay unregistered unless you opt in: group calls behind `MCP_TELEGRAM_ENABLE_GROUP_CALLS=1`, Stars behind `MCP_TELEGRAM_ENABLE_STARS=1`, quick replies behind `MCP_TELEGRAM_ENABLE_QUICK_REPLIES=1`
  • Several features need Telegram Premium — audio transcription, stealth mode, emoji status — and the Business suite needs a Business subscription
Requirements

A Telegram API ID and API hash from my.telegram.org, set as `TELEGRAM_API_ID` and `TELEGRAM_API_HASH`, then a QR login that creates a local session file. The simplest install is a standalone binary from GitHub Releases — one file, no Node.js — with builds for macOS arm64 and x64, Linux x64 and arm64, and Windows x64. With Node.js 18+ you can instead run `npx @overpod/mcp-telegram login` then `npx @overpod/mcp-telegram`, or install globally, or use Docker. Package version 1.41.5.

Setup effort

One command plus a key — npx @overpod/mcp-telegram, then supply credentials