overpod/mcp-telegram

Overview

A Telegram MCP server using MTProto protocol, offering tools for reading chats, searching messages, downloading media, and managing contacts. Features QR code login, session persistence, and npx zero-install with a hosted version available.

Capabilities

• • github integration
• • mcp client integration

Best For

Telegram MCP server with MTProto protocol, chat tools, QR login, and npx install for message and contact management.

Decision Snapshot

• • GitHub stars: 5
• • Forks: 1
• • Source provenance count: 1
• • Last seen: 3/23/2026
• • Published: 3/16/2026

Installation / Setup

npm install -g @overpod/mcp-telegram && mcp-telegram          # run server && mcp-telegram login    # QR login

This is an MCP Find-authored example config generated from strong evidence.

Review official documentation and source metadata for complete setup parameters.

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "npx"
    }
  }
}

Usage

{ && "mcpServers": { && "telegram": { && "command": "npx",

Features

• • **MTProto protocol** -- direct Telegram API access, not the limited Bot API
• • **Userbot** -- operates as your personal account, not a bot
• • **Full-featured** -- messaging, reactions, polls, scheduled messages, media, contacts, and more
• • **QR code login** -- authenticate by scanning a QR code in the Telegram app
• • **Session persistence** -- login once, stay connected across restarts
• • **Human-readable output** -- sender names are resolved, not just numeric IDs
• • Go to my.telegram.org and log in with your phone number.
• • Navigate to **API development tools**.

Use Cases

• • Supports capabilities such as: github integration; mcp client integration.
• • Common usage themes: mcp, curated, markdown-list, awesome-mcp-servers-punkpeye.

Supported Clients / Integrations

• • github integration
• • mcp client integration

Compatibility Signals

• • GitHub: supports (Detected in parser config/capability hints.)

Prompt Examples

Notes / Requirements

• • Primary language: TypeScript
• • License: MIT
• • Documentation coverage: medium
• • Parser coverage score: 1.00
• • Source feeds: Awesome MCP Servers (punkpeye)
• • Topic cluster: general

Official Links

• Repository
• Documentation 1
• Documentation 2

Source Information

Related MCP Tools