Telegram (tg-mcp)

● Active

io.github.qelphybox/tg-mcp

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

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "tg-mcp": {
      "url": "https://connector.tgmcp.dev/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http tg-mcp https://connector.tgmcp.dev/mcp
VS Code
code --add-mcp '{"name":"tg-mcp","type":"http","url":"https://connector.tgmcp.dev/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Communication
Version
0.1.3
Registry
active
Published
11/14/2026

Live check

checked Nov 19, 2026, 04:09 UTC
● Needs sign-in

The endpoint is up but wants a key or an OAuth sign-in before the handshake, so its tools can only be read with an account.

Checked by Serverdex with a plain initialize + tools/list call to connector.tgmcp.dev/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 15, 2026
Stars
2
Forks
0
Last push
Nov 15, 2026
License
MIT

Rustaiaxumchatgptclaudegeminillmmcpmcp-servermodel-context-protocolmtprotomtproto-apimtproto-clientmtproto-proxyoauth2remote-mcprustself-hostedtelegramtelegram-api-alternativetelegram-api-integration

From the README

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 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.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://connector.tgmcp.dev/mcp

Alternatives to Telegram (tg-mcp)

Best Communication servers →

The most-starred Communication servers in the index, with their live-check result.

ServerStarsLast pushLive check
Inbox Zero13,026Nov 2026Needs sign-in
Agent-Native Brain7,707Nov 2026Needs sign-in
Agent-Native Chat7,707Nov 2026Needs sign-in
Agent-Native Dispatch7,707Nov 2026Needs sign-in
Agent-Native Mail7,707Nov 2026Needs sign-in

Telegram (tg-mcp): questions people ask

Is Telegram (tg-mcp) a remote or a local MCP server?
According to its entry in the official MCP registry, Telegram (tg-mcp) ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Telegram (tg-mcp) need an API key or a sign-in?
Yes. Its hosted endpoint answered the credential-free Serverdex live check with HTTP 401/403 on Nov 19, 2026: it expects an API key in a header or an OAuth login before it lists its tools.
Is Telegram (tg-mcp) still maintained?
Active: the repository's last commit 4 days ago. Last push Nov 15, 2026, 2 GitHub stars, MIT licence. Read from GitHub on Nov 15, 2026.
How do I add Telegram (tg-mcp) to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Communication →

Add the badge to your site

Show visitors that Telegram (tg-mcp) is listed here — it’s also the link we check for a free listing.

Telegram (tg-mcp) — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-qelphybox-tg-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Telegram (tg-mcp) — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Telegram (tg-mcp) — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-qelphybox-tg-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.