Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Telegram (tg-mcp)

de qelphyboxversión 0.1.3i★ 2iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registroio.github.qelphybox/tg-mcp

Cómo instalar

What it does

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

  • Connects Se ejecuta en la nube
  • Account or key Sign in to the service when you connect (OAuth)
  • Category Chat y correo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad6/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso26/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Telegram (tg-mcp). Sigue https://mcp.popnx.com/i/qelphybox-tg-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (connector.tgmcp.dev) · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreTelegram (tg-mcp)
    Remote MCP server URL · Direcciónhttps://connector.tgmcp.dev/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsTelegram (tg-mcp)

  4. Pruébalo

    Usa Telegram (tg-mcp) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Telegram (tg-mcp) o muestra una herramienta de Telegram (tg-mcp) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreTelegram (tg-mcp)
    Connection · Direcciónhttps://connector.tgmcp.dev/mcp
  3. Elige Telegram (tg-mcp) en un chat

    Abre un chat nuevo y elige Telegram (tg-mcp) en tus plugins antes de escribir

  4. Pruébalo

    Usa Telegram (tg-mcp) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Telegram (tg-mcp) o muestra una herramienta de Telegram (tg-mcp) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

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

    Deberías ver Telegram (tg-mcp) en la lista como conectado

  4. Pruébalo

    Usa Telegram (tg-mcp) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Telegram (tg-mcp) o muestra una herramienta de Telegram (tg-mcp) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Telegram (tg-mcp) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Telegram (tg-mcp) o muestra una herramienta de Telegram (tg-mcp) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Telegram (tg-mcp) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Telegram (tg-mcp) o muestra una herramienta de Telegram (tg-mcp) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://connector.tgmcp.dev/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Telegram (tg-mcp)💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la 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"
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
0.1.3
Categoríai
Chat y correo
Publicado en el registroi
14 nov 2026
Último cambio de códigoi
15 nov 2026
Última revisión
18 nov 2026
Creador
qelphybox
Sitio web
tgmcp.dev
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub qelphybox, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 4 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 507 ms (HTTP 401)

  • ✓ Superada

    Inicio de sesión con OAuth

    Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

La dirección en la nube respondió 4 de las últimas 4 comprobaciones · última 507 ms · revisado 18 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Chat y correoi

  • Más estrellas que el 88% de los otros 2018 servidores de esta categoría
  • Publicado en el registro más recientemente que el 85% de los otros 2018 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 2018 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Telegram (tg-mcp)?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 4 días, y la última versión (0.1.3) llegó al registro hace 5 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

emailmd

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

de anypostMuy usado↓ 5,4 mil/sem★ 1,4 milActualizado hace 5 días

Computadora o nube✓ del servicio · emailmd.dev

Kite Discord Bot Builder

Build and fix Discord bots from a chat. Kite hosts them 24/7, with no code to deploy.

de merlinfuchsEn crecimiento★ 334 Estrellas de todo el repositorioActualizado hace 22 días

Se ejecuta en la nube✓ del servicio · kite.onl

e2a — email for AI agents

Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

de tokencanopyEn crecimiento★ 200 Estrellas de todo el repositorioActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · e2a.dev

Infobip MCP

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

de infobipInicial★ 36Actualizado hace 13 meses

Se ejecuta en la nube✓ del servicio · infobip.com

kernelCAD

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

de w1neInicial★ 35Actualizado hace 23 días

Se ejecuta en la nube✓ del servicio · kernelcad.com
Comparado con otros parecidos
Este
Telegram (tg-mcp)
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
Dónde se ejecutaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoSíNo
Revisiones básicas5/55/54/44/44/44/4
LicenciaMITMITAGPL-3.0Apache-2.0MITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Solo se muestra el principio; lee el resto en el repo