Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Telegram (tg-mcp)

by qelphyboxversion 0.1.3i★ 2iRuns in the cloudOfficial site ↗
Registry nameio.github.qelphybox/tg-mcp

How to install

What it does

Your personal Telegram account for AI: read, search and sum up chats. QR login, no API key.

  • Connects Runs in the cloud
  • Account or key Sign in to the service when you connect (OAuth)
  • Category Chat & email

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity6/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score26/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

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

Let your AI install it with one sentence

Please install Telegram (tg-mcp). Follow https://mcp.popnx.com/i/qelphybox-tg-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (connector.tgmcp.dev) · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameTelegram (tg-mcp)
    Remote MCP server URL · Addresshttps://connector.tgmcp.dev/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsTelegram (tg-mcp)

  4. Try it

    Use Telegram (tg-mcp) and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Telegram (tg-mcp) or shows a Telegram (tg-mcp) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameTelegram (tg-mcp)
    Connection · Addresshttps://connector.tgmcp.dev/mcp
  3. Pick Telegram (tg-mcp) in a chat

    Start a new chat and pick Telegram (tg-mcp) from your plugins before typing

  4. Try it

    Use Telegram (tg-mcp) and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Telegram (tg-mcp) or shows a Telegram (tg-mcp) tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user tg https://connector.tgmcp.dev/mcp
  3. Type /mcp in Claude Code

    You should see Telegram (tg-mcp) listed as connected

  4. Try it

    Use Telegram (tg-mcp) and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Telegram (tg-mcp) or shows a Telegram (tg-mcp) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Telegram (tg-mcp) and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Telegram (tg-mcp) or shows a Telegram (tg-mcp) tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Telegram (tg-mcp) and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Telegram (tg-mcp) or shows a Telegram (tg-mcp) tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://connector.tgmcp.dev/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Telegram (tg-mcp)💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user tg https://connector.tgmcp.dev/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "tg": {
      "url": "https://connector.tgmcp.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "tg": {
      "type": "http",
      "url": "https://connector.tgmcp.dev/mcp"
    }
  }
}

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

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
0.1.3
Published to registryi
Nov 14, 2026
Code last changedi
Nov 15, 2026
Last checked
Nov 18, 2026
Maker
qelphybox
Website
tgmcp.dev
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

The server asks you to sign in before it lists its tools.

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 19, 2026

  • ✓ Pass

    Maker matches the repo

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

  • ✓ Pass

    Still maintained

    Code last changed 4 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 507 ms (HTTP 401)

  • ✓ Pass

    Sign-in with OAuth

    Declares OAuth sign-in, so your AI app can take you to log in

  • … Not checked yet

    No hidden instructions in tool descriptions

    Not checked yet; we read the tool list when we check the endpoint

The cloud address answered 4 of the last 4 checks · latest 507 ms · checked Nov 18, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/qelphybox-tg-mcp.svg)](https://mcp.popnx.com/en/servers/qelphybox-tg-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Chat & emaili

  • More stars than 88% of the other 2018 servers in this category
  • Published to the registry more recently than 85% of the other 2018 servers in this category
  • Basic checks equal to or better than 99% of the other 2018 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 Telegram (tg-mcp) safe?

It passed 5 of 5 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?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 4 days ago, and the latest version (0.1.3) reached the registry 5 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 on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

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

emailmd

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

by anypostWidely used↓ 5.4K/wk★ 1.4KUpdated 5 days ago

Computer or cloud✓ service owner · emailmd.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

by infobipEarly★ 36Updated 13 months ago

Runs in the cloud✓ service owner · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

by w1neEarly★ 35Updated 23 days ago

Runs in the cloud✓ service owner · kernelcad.com
Compared with similar ones
This one
Telegram (tg-mcp)
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
Runs whereRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoYesNo
Basic checks5/55/54/44/44/44/4
LicenseMITMITAGPL-3.0Apache-2.0MITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

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.

tg-mcp

Unofficial remote MCP server that gives AI clients (Claude, ChatGPT, Gemini, Claude Code, Cursor, …) read access to your personal Telegram account and, only if you allow it, lets them write Drafts that you send yourself, or send messages to chats you choose, and react and mark as read there. You add a URL, log in by scanning a QR code, and you're done.

Not affiliated with or endorsed by Telegram. It uses the Telegram API through its own registered app ("Unofficial MCP Server"). Nothing is ever edited or deleted, and nothing is forwarded. A connection writes only what you ticked for it: Write Drafts, text in a chat's message field that you send yourself; Send messages, messages to the chats you chose, sent at once (your AI app decides whether it asks you first), plus reactions and read marks in those chats. Without either, nothing is ever written.

Quick start

Website: tgmcp.dev. Public instance: https://connector.tgmcp.dev/mcp

Claude Code

claude mcp add --transport http telegram https://connector.tgmcp.dev/mcp

Then run /mcp in Claude Code → telegram → Authenticate. A browser opens:

  1. Scan the QR code with Telegram on your phone: Settings → Devices → Link Desktop Device.
  2. If your account has a cloud password (two-step verification), type it on the same page. It goes only to this server's login page, never through the AI client or the chat.
  3. Allow on the consent screen. Reading is always included; leave Write Drafts and Send messages unticked to keep the connection read-only. Write Drafts ticked, the AI can also put text into a chat's message field on all your devices (save_draft), replacing the Draft there; only you can send it. Send messages ticked, you choose the chats it may send to (Chat folders, your 100 most recent chats, or a chat found by name: only chats you already have). A message the AI sends there (send_message) goes out at once; whether you are asked first is up to your AI app (Claude Code asks by default). In those chats it may also react to messages (react) and mark them as read (mark_read).

Claude (web/desktop/mobile, free plan too): Settings → Connectors → Add custom connector → the same URL. ChatGPT (paid plans): Settings → Apps & Connectors → Advanced → turn on Developer mode, then Create → the same URL. Gemini (personal Google accounts, add it on the web): Settings → Connected apps → Add a custom app → the same URL. Other MCP clients: add it as a streamable-HTTP server; they discover OAuth on their own.

Tools

ToolWhat it returns
whoamiThe connected account: id, name, @username, and its Chat folders (chat_folders: id, title, emoji, rules when a folder is defined by rules rather than a list of chats), in the app's order.
list_chatsChats, most recent first: id, title, type, unread count, muted and marked_unread flags, last-message preview (text or caption, and the kind of media). Paged by cursor; archived lists the Archive folder. unread_only lists only chats with unread messages or marked as unread ("what did I miss"): Telegram can't filter by unread, so one call reads at most 500 chats and says unread_scan_truncated when it stopped there; next_cursor reads on. chat_folder lists one Chat folder as its tab in the app (folder-pinned first, archived chats included; with unread_only too); folders defined by rules aren't supported yet.
get_messagesMessages of one chat, newest first: sender, date, text (or caption), media (kind: photo, video, video note, voice, audio, document, sticker, GIF, location, contact, poll or other; with duration, size, MIME type, file name and dimensions when Telegram sends them; a poll with its question, options, state and, when Telegram shows them to the account, vote counts and its own vote, never who voted), reply/forward/edit marks, reactions (count per emoji, custom emoji summed as custom, Stars as paid), a t.me link to the message (channels and supergroups) and pinned; in a forum, each message's topic and the page's topics (id → title of the Topics it mentions), and topic reads one Topic only. Paged by before_id; pinned_only reads only the pinned messages; since/until narrow by time; around_id gives a window around one message (e.g. a search hit), continued with before_id / after_id; thread_of gives the chain of messages one message replies to, up to its root or depth ancestors (default 10, max 50), saying where a deleted parent broke it (broken_at) or which chat it goes on in (continues_in). A channel post with comments on says how many (comments); comments_of reads a post's comments from the channel's discussion group, newest first, paged by before_id.
get_chat_infoTitle, type, @username of one chat; a group's or channel's description and member count. For a user, the profile Telegram shows the account: bio, last-seen status (online, last_seen with the exact time, or recently / last_week / last_month / long_ago when hidden), bot flag and bot description, verified/premium/scam/fake flags, phone and birthday only when shown to the account, and the number of common groups and channels; common_chats: true also lists them (at most 20, ids usable with the other tools). A forum lists its topics (up to 50: id, title, closed, pinned; topics_truncated when there are more).
get_membersMembers of a group, supergroup or channel: id (usable with the other tools), name, @username, role (creator / admin / member), bot flag. query filters by name or @username, admins_only lists only the creator and admins; Telegram's approximate total count. Paged by cursor, up to 200 per page (the last page may be empty). The list may be incomplete: Telegram hides members in some groups (members_hidden), shows a channel's subscribers only to its admins (an error says so) and stops listing a large group after about 10,000 members.
search_messagesTelegram's own search by words (not meaning), newest first: across all chats, or in one with chat_id. Each hit: its chat (id, title, type), message id, date, sender, a ~300-character snippet around the match, the kind of media, and the reactions, link, pin and forum topic of get_messages (titles in the page's topics); read it in context with get_messages around_id. Narrow with since/until and media; across chats with chat_type and archived, in one chat with from (a sender, or me) and, in a forum, topic. Paged by cursor, at most 50 hits per page, no total count.
get_mediaThe media of one message (chat_id, message_id, mode). Mode view: the picture itself as image content the model looks at, so a client without a shell (Claude on the web, desktop or phone) sees it: a photo in Telegram's ~800 px size (size: "large": ~1280 px), the thumbnail of a video, video note, GIF, sticker or file, or a whole album (up to 4 images in message order, album_truncated when there are more), at most ~1 MB per call, as Telegram's own JPEGs (no processing on the server), with a short text saying what each image is. Mode transcribe: what is said in a voice message or video note, as text, by Telegram's own transcription (the audio never leaves Telegram; no other speech-to-text is used): it waits up to 20 s and answers done with the text (up to 16000 characters) or pending with retry_after_s; it needs Telegram Premium or Telegram's weekly free trial (trial_remaining says what is left), otherwise it is an error pointing to download. Mode download: a Media link for an agent with a shell to fetch with curl or wget (url, expires_at, mime_type, size_bytes, duration_s, suggested_filename). It works for 5 minutes and 3 downloads, without a token, for photos (original size), videos, video notes, voice messages, audio, documents, stickers and GIFs up to 20 MB. The file is streamed from Telegram straight into the download, never stored. Voice messages are OGG/Opus and video notes MP4: convert or transcribe them locally (or use transcribe).
find_chatsThe account's own chats and contacts by name, title or @username (@ optional), via Telegram's chat search: id, title, type, @username, at most 30. Contacts without a chat are included; public chats the account hasn't joined never are. No paging and no fallback: a chat it doesn't find is still in list_chats.
get_draftsThe account's Drafts (unsent text in chats' message fields, typed in any Telegram app or written by save_draft), newest first: chat (id, title, type, Saved Messages marked is_self), forum topic, reply_to, date and text without its formatting. At most 100 Drafts and ~40,000 characters per call, newest kept (truncated when older ones are left out).
save_draftWrites; needs the `draft` Scope (absent from tools/list without it). Puts text into one chat's message field on all your devices, replacing the Draft there; "" clears it. Nothing is sent: you send it from Telegram. format markdown (default: **bold**, *italic* / _italic_, `code` , ``` code blocks, [text](https://…) links; anything else stays as typed) or plain. At most 4096 characters once formatted, never split. reply_to a message of the same chat; in a forum, topic (or a reply_to in a Topic) says which Topic's field. Any chat of the account's, Saved Messages too; each call counts against the writes budget. Returns saved / cleared, never the text.
send_messageSends as you; needs the `send` Scope (absent from tools/list without it). Sends text at once to one chat of the connection's Send allow-list (any other chat is an error). Annotated destructive and open-world, so clients ask you by default; the server doesn't rely on it. Text as save_draft's (Markdown subset or plain, 1 to 4096 characters once formatted, never split; reply_to; topic or a reply_to in a Topic in a forum), no media, no forwarding. Returns sent with message_id and date. The same text to the same chat within 60 s of sending it is refused as "already sent: message N". Each message counts against the writes budget and the chat's Send cap (5 a minute); a refusal says when to retry, and nothing is retried or queued.
reactWrites; needs the `send` Scope. Sets your reaction on one message of a chat of the Send allow-list to one standard emoji (as Telegram lists them: 👍 ❤ 🔥 …; ❤️ and ❤ are the same), replacing your previous reaction there; emoji: null removes it. Custom emoji and paid (Stars) reactions are refused, and so is an emoji the chat doesn't allow (some chats allow only some reactions, or none). Setting the same reaction again is no error. Counts against the writes budget, not the Send cap. Returns set (with the emoji as Telegram names it) or removed.
mark_readWrites; needs the `send` Scope. Marks a chat of the Send allow-list as read on all your devices, up to its latest message or up to up_to; in a forum, topic marks only that Topic. In a private chat the other person sees their messages as read. Marking again is no error. Counts against the writes budget, not the Send cap. Returns the chat, topic and up_to it marked.

_Experimental, off by default: with TG_MCP_EXPERIMENTAL_DOCUMENTS=1, get_media also takes mode document (a PDF or plain-text file as an embedded resource in the result; a #58 prototype that may change or go away)._

Chat ids look like user:123~a-MGLzhi9Ek, chat:456 (basic group) or channel:789~18YMXnDF6JI (channels and supergroups), as returned by list_chats, find_chats and in message senders; the part after ~ is the access hash Telegram needs, so an id works without the server looking it up. Ids without it (user:123) are st

Only the beginning is shown; read the rest in the repo