Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

Fast MCP Telegram

by leshchenko1979version 0.46.1i★ –iComputer or cloud
Registry nameio.github.leshchenko1979/fast-mcp-telegram

Install

Overview

Description from the maker (original English)

Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Computer or cloud
  • Transport: stdio, Streamable HTTP
  • Category: Chat & email
  • You need to fill in: API_ID, API_HASH

Install

Pick the AI app you use, then copy the settings.

Before you install

  • Basic checks: 3 of 3 passed
  • Runs on the maker’s server: what you ask it goes through their server.
  • Can do 8 things (tools) search_messages_globally, get_messages, send_message, edit_message …
  • You fill in yourself: API_ID, API_HASH, SERVER_MODE, SESSION_DIR

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

  • Runs in the cloudNothing to install; it connects over the internet
  • PyPIPython’s uv installed (for the uvx command)

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

  1. Open Settings → Connectors
  2. Press Add custom connector
  3. Paste the address below and press Add
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Add2https://…3
https://tg-mcp.l1979.ru/v1/mcp

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "fast-telegram": {
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "your-value",
        "API_HASH": "your-value",
        "SERVER_MODE": "your-value",
        "SESSION_DIR": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add --transport http fast-telegram https://tg-mcp.l1979.ru/v1/mcp

Or run it on your computer

claude mcp add fast-telegram --env API_ID=your-value --env API_HASH=your-value --env SERVER_MODE=your-value --env SESSION_DIR=your-value -- uvx fast-mcp-telegram

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "fast-telegram": {
      "url": "https://tg-mcp.l1979.ru/v1/mcp"
    }
  }
}

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "fast-telegram": {
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "your-value",
        "API_HASH": "your-value",
        "SERVER_MODE": "your-value",
        "SESSION_DIR": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "fast-telegram": {
      "type": "http",
      "url": "https://tg-mcp.l1979.ru/v1/mcp"
    }
  }
}

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "fast-telegram": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "your-value",
        "API_HASH": "your-value",
        "SERVER_MODE": "your-value",
        "SESSION_DIR": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

  1. Open ChatGPT on the web → Settings → Connectors (Apps)
  2. Press Create or Add (some plans need Developer mode under Advanced first)
  3. Paste the address below, give it a name and save
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Create2https://…3
https://tg-mcp.l1979.ru/v1/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

  • API_ID required env
    Telegram API ID from my.telegram.org
  • API_HASH secret required env
    Telegram API Hash from my.telegram.org
  • SERVER_MODE env
    Server mode: stdio (local), http-no-auth (dev), http-auth (prod)
  • SESSION_DIR env
    Custom session directory (defaults to ~/.config/fast-mcp-telegram/)

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.

  • search_messages_globally

    Search all Telegram chats at once (not scoped to one chat). Comma-separated query terms; optional filters by date, chat kind, and public username. Results are ordered by ascending date-time (oldest first); limit selects the newest N. Success: message list and metadata dict. Globa

  • get_messages

    Read or search messages in one chat: browse latest, search text, fetch by ids, or load replies to a message (comments, forum topics, threads). Use from_user to filter by sender (server-side, per-chat only). Use context to include neighboring messages and reply chains around each

  • send_message

    Send text and optional file attachments to a Telegram chat. Supports reply-to (including forum topics and channel discussion groups), parse_mode: classic markdown/html/auto (entities) or rich (Rich Message document; dialect auto-detected). parse_mode=rich cannot be combined with

  • edit_message

    Replace the text of an existing message in a Telegram chat. Only works on messages sent by the authenticated account. Cannot edit media or other message attributes — text only. parse_mode: classic markdown/html/auto or rich (Rich Message; dialect auto-detected). schedule_date (IS

  • find_chats

    Find users/groups/channels by name, username, or phone. Comma-separated usernames are searched in parallel and results are merged round-robin. Global search (query required) searches all Telegram; with min_date, max_date, or filter, search uses dialog list or a named filter; incl

  • get_chat_info

    Load profile and metadata for one user, bot, group, or channel. Success: info dict; forum chats may include topics up to topics_limit; user targets may include common_chats up to common_chats_limit. Full documentation: https://github.com/leshchenko1979/fast-mcp-telegram/blob/main

  • send_message_to_phone

    Send to a phone number: may create a temporary contact, then send text or files. Supports parse_mode: classic markdown/html/auto or rich (Rich Message; dialect auto-detected). parse_mode=rich cannot be combined with files. schedule_date (ISO 8601, future) queues the message inste

  • invoke_mtproto

    Low-level Telegram API (MTProto) invoke for methods not wrapped by other tools. Dangerous methods require allow_dangerous=true. Success: API result dict or normalized error. PII and credential-shaped fields (phone, access_hash) are dropped from a successful result by default; pas

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account leshchenko1979, which owns the repo

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 1089 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 8 tool descriptions and found no hidden instructions to the AI

Compared with others in Chat & emaili

  • More stars than 0% of the other 1850 servers in this category
  • Published to the registry more recently than 62% of the other 1850 servers in this category
  • Basic checks equal to or better than 100% of the other 1850 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Fast MCP Telegram safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: API_ID, API_HASH

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.46.1) reached the registry 19 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Vexa, emailmd, MCP WhatsApp Cloud

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

by Vexa-aiWidely used★ 2.9KUpdated 2 months ago

Runs in the cloud✓ vexa.ai

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

by anypostGrowing↓ 5.3K/wk★ 1.4KUpdated 32 days ago

Computer or cloud✓ emailmd.dev

MCP WhatsApp Cloud

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

by codesparEarly↓ 63/wk★ 277Updated 5 months ago

Runs on your computer

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Telegram MCP Server — Model Context Protocol (MCP) gateway for Telegram. 8 context-efficient tools, multi-tenant, MTProto bridge.

Try the Demo

  1. Open https://tg-mcp.l1979.ru/setup
  2. Scan the QR code from Telegram mobile (Settings → Devices → Scan QR) — no phone typing, no OTP, no 2FA. Or enter your phone number as fallback.
  3. Copy your Bearer token from the success page

Then choose your path:

MCP Client (AI assistants)

  • From the setup page, download the mcp.json file
  • Add the server to your AI client and ask: "send hello to my saved messages in telegram"

Direct API (curl)

  • Run the command below (replace TOKEN with yours):
curl -X POST "https://tg-mcp.l1979.ru/mtproto-api/messages.SendMessage" \

-H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{"params": {"peer": "me", "message": "Hello!"}}'

How It Works

This server sits between your AI agent and Telegram's API:

Your agent → MCP/HTTP → this server → MTProto → Telegram

What it does: Authenticates you with Telegram (QR or phone/bot token), exposes 8 AI-friendly tools instead of 80+ micro-APIs, and bridges raw MTProto for power users. Multi-tenant — one server, many users, isolated sessions.

Features

FeatureDescription
:building_construction: [Dual Transport](docs/Installation.md#overview)Stdio for local MCP clients, HTTP for remote deploys (http-auth production, optional http-no-auth for dev)
:closed_lock_with_key: [Multi-User Authentication](docs/Installation.md#remote-setup-http-auth)Shared http-auth server: one Bearer token per user, one Telegram account per MCP connection. QR login for instant auth — no phone/OTP/2FA.
:dart: [AI-Optimized](docs/Tools-Reference.md#overview)8 consolidated tools vs 80+ micro-tools — context-efficient design, LLM-friendly API, MCP ToolAnnotations
:globe_with_meridians: [HTTP-MTProto Bridge](docs/MTProto-Bridge.md#key-benefits)Direct curl access to any Telegram API method with entity resolution and safety guardrails
:shield: [Session ACL](docs/Installation.md#session-acl-http-auth)Opt-in per-principal limits on http-auth (ACL_ENABLED) — chat lanes, read_only, blocked_peers, allow_mtproto, ACL_DENY_UNLISTED_PRINCIPALS; see SECURITY.md
:tv: [QR & Web Setup](docs/Installation.md#web-setup-interface)Scan QR from Telegram mobile for instant auth (no phone/OTP/2FA) or use phone/code/2FA fallback — live at /setup
:label: [One Agent, Multiple Accounts](docs/Installation.md#multi-account-mcp-tool-prefix)Optional PREFIX_MCP_TOOLS_WITH_ACCOUNT — when one agent uses several MCP connections (same server, different tokens), prefixes tool names so they do not collide; not needed for standard multi-user hosting
:rocket: [MTProto Proxy Support](docs/Installation.md#mtproto-proxy)Connect via MTProto proxy with automatic Fake TLS (EE prefix) and standard proxy detection
:card_file_box: [Unified Session Management](docs/Installation.md#configuration-reference)Single configuration system for setup and server; per-token session files on shared multi-user hosts
:cloud: [S3 Session Storage](docs/Installation.md#s3-session-storage-optional)Store sessions in S3-compatible object storage for ephemeral hosted deployments (Smithery, Fly.io, Railway)
:mag_right: [Intelligent Search](docs/Search-Guidelines.md#what-works)Global & per-chat message search with multi-query support and intelligent deduplication
:mag: [Unified Message API](docs/Tools-Reference.md#2-read)Single get_messages tool for search, browse, read by IDs, and replies - 5 modes in one
:speech_balloon: [Universal Replies](docs/Tools-Reference.md#2-read)Get replies from channel posts, forum topics, or any message with one parameter
:busts_in_silhouette: [Smart Contact Discovery](docs/Tools-Reference.md#1-discovery)Search users, groups, channels with uniform entity schemas, forum detection, profile enrichment
:file_folder: [Folder Filtering](docs/Tools-Reference.md#1-discovery)Filter chats by dialog folder (archived, custom folders) with integer ID or name matching
:envelope: [Advanced Messaging](docs/Tools-Reference.md#3-write)Send, edit, reply, post to forum topics, formatting, file attachments, and phone number messaging
:paperclip: [Secure File Handling](docs/Tools-Reference.md#3-write)Rich media sharing with SSRF protection, size limits, album support, optional HTTP attachment streaming
:outbox_tray: [Inline File Uploads](docs/Tools-Reference.md#3-write)Data: URI (base64) file uploads in files param — work in all transport modes, filenames preserved, images sent as photos
:microphone: [Voice Transcription](docs/Tools-Reference.md#get_messages)Automatic speech-to-text for Premium accounts with parallel processing and polling
:zap: High PerformanceAsync operations, parallel queries, and memory-conscious batching
:shield: Production ReliabilityAuto-reconnect, configurable logging, comprehensive error handling

Quick Start

1. Install and authenticate

Quickest path (remote server): Open /setup → scan QR → copy token (see Try the Demo).

CLI path (local stdio): Run fast-mcp-telegram-setup once to create a Telegram session — then fast-mcp-telegram serves it:

uvx --from fast-mcp-telegram fast-mcp-telegram-setup \

--api-id="your_api_id" \ --api-hash="your_api_hash" \ --phone-number="+123456789"

Bot token alternative (no phone, no OTP): Set BOT_API_TOKEN instead of --phone-number. See Installation Guide.

2. Configure MCP Client

stdio mode (local): Add to your MCP client config (e.g. claude_desktop_config.json) — stdio (standard input/output) is the default transport for local MCP clients:

{

"mcpServers": { "telegram": { "command": "uvx", "args": ["fast-mcp-telegram"], "env": { "API_ID": "your_api_id", "API_HASH": "your_api_hash" } } } }

http-auth mode (remote): Add to your MCP client config (e.g. claude_desktop_config.json):

{

"mcpServers": { "telegram": { "url": "https://tg-mcp.l1979.ru/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

Get your token by scanning the QR code on the setup page or see Installation Guide for deploying your own server.

3. Start Using
{"tool": "search_messages_globally", "params": {"query": "hello", "limit": 5}}

{"tool": "get_messages", "params": {"chat_id": "me", "limit": 10}} {"tool": "send_message", "params": {"chat_id": "me", "message": "Hello!"}}

Deploy to Remote Server

Deploy your own MCP server on a VDS — see Installation Guide for step-by-step instructions.

Available Tools

ToolPurposeKey Features
search_messages_globallySearch across all chatsMulti-term queries, date filtering, chat type filtering
get_messagesUnified message retrievalSearch/browse, read by IDs, get replies (posts/topics/messages), date filtering in all modes
send_messageSend new messageFile attachments (URLs/local/data URIs), classic formatting (markdown/html), parse_mode=rich Rich Messages, reply to forum topics
edit_messageEdit existing messageClassic or parse_mode=rich formatting
find_chatsFind users/groups/channelsMulti-term search, contact discovery, folder filtering, username/phone lookup
get_chat_infoGet detailed profile infoMember counts, bio/about, online status, forum topics, common groups, enriched data
send_message_to_phoneMessage phone numbersAuto-contact management, optional cleanup, file support (URLs/data URIs), parse_mode=rich
invoke_mtprotoDirect Telegram API (power user)Raw MTProto methods, entity resolution, PII/credential fields dropped by default (include_sensitive=true for raw) — see MTProto Bridge

See Tools Reference for detailed documentation with examples.

Documentation

  • Installation Guide - Local setup and remote server deployment
  • Tools Reference - Complete tools documentation
  • MTProto Bridge - Direct API access via curl
  • Contributing - Guidelines for contributors
  • Security - Security features and best practices

Telemetry

Anonymous tool telemetry since v0.30.1 — heartbeat every 6h, no credentials or message content collected. Opt out with DO_NOT_TRACK=1. See ADR 0005.

Auth flow telemetry since v0.38.0 — atomic events during setup (phone, QR, bot token, reauthorize). Buffered flush on flow completion. See ADR 0008.

License

MIT License - see LICENSE

mcp-name: io.github.leshchenko1979/fast-mcp-telegram

Ask PopNx