¿Qué es Telegram Archive MCP?
telegram-archive-mcp, del usuario de GitHub GeiserX, conecta un cliente MCP con una instancia de Telegram Archive, la herramienta de copias de seguridad autoalojada del mismo autor que copia una o varias cuentas de Telegram en SQLite o PostgreSQL y las sirve mediante un visor web. El servidor MCP solo habla con ese visor, e inicia sesión en su endpoint /api/login con un usuario y una contraseña del visor; nunca se conecta a Telegram.
Ofrece 12 herramientas y 4 recursos: listar chats y carpetas, buscar en un chat o en todos, leer un chat página a página o día a día, recuperar los mensajes alrededor de uno concreto, listar temas de foro y mensajes fijados, obtener estadísticas por chat y devolver una foto adjunta como imagen que el modelo puede ver. Todas las herramientas leen, salvo refresh_stats, que pide al visor recalcular las estadísticas del archivo y desaparece con READ_ONLY=1. Está escrito en Go, con licencia GPL-3.0-or-later, y se distribuye por npm, Docker y binarios precompilados; la versión 0.4.2 salió el 11 de noviembre de 2026.
Cómo instalar Telegram Archive MCP
npx -y telegram-archive-mcp¿Merece la pena Telegram Archive MCP?
La decisión de diseño importante es que este servidor nunca toca Telegram. Lee del visor de Telegram Archive, que ya guarda una copia de tus mensajes en tu propio disco, así que un agente no puede enviar un mensaje, salir de un grupo ni activar los sistemas antispam de Telegram. Lo peor que puede hacer un modelo descontrolado es leer de más, más una única escritura: refresh_stats, que solo hace que el visor vuelva a contar sus estadísticas.
Las herramientas están pensadas para cómo se busca de verdad en un historial de chat. Buscar en todos los chats a la vez, leer un día concreto en tu zona horaria y sacar los mensajes de antes y después de un resultado responden a preguntas como qué se acordó en el grupo del proyecto un martes concreto. Se admiten temas de foro y carpetas, y las fotos llegan reducidas a 1.568 píxeles para que un modelo con visión pueda leer una captura que alguien publicó.
Los valores de red por defecto son mejores que los de la mayoría de los servidores comunitarios. Por stdio no escucha nada. El modo Streamable HTTP se enlaza a loopback, comprueba la cabecera Origin, limita el tamaño de las peticiones y se niega a arrancar en cualquier otra dirección sin MCP_AUTH_TOKEN. La versión 0.4.2 recompiló el servidor con Go 1.27.4 precisamente para que una petición demasiado grande no pudiera tumbarlo.
La pega: solo es tan útil como el archivo que tiene detrás, y eso es un compromiso. Telegram Archive necesita Docker Compose, un API ID y un hash de Telegram, y un inicio de sesión en tu cuenta; guarda las ediciones y los mensajes borrados, incluidos los de otras personas. Conectar un cliente MCP envía esos mensajes, también los borrados, al proveedor de modelos que use el cliente. El proyecto además es pequeño: 13 estrellas el servidor MCP, 252 Telegram Archive y unas 2.100 descargas en npm el último mes, con todos los commits humanos de un solo mantenedor.
Nuestra opinión: si ya has decidido guardar tu historial de Telegram en un servidor doméstico, esta es una forma cuidadosa de hacerlo consultable por un asistente. Crea una cuenta de visor limitada a los chats que quieras hacer buscables en lugar de entregar el usuario de administrador.
Dónde se gana su sitio
Un desarrollador autónomo que acuerda el alcance con clientes en grupos de Telegram
Encontrar qué aprobó de verdad un cliente hace tres meses
Pide al asistente que busque el nombre de la funcionalidad en el grupo del cliente y luego lea los mensajes de alrededor y el hilo de ese día. Lleva segundos en vez de desplazarse sin fin; el coste es el servidor que aloja el archivo.
Un moderador de un grupo de Telegram con foro y 5.000 miembros
Resumir un tema muy activo para quienes se perdieron una semana
Lista los temas del foro del grupo, lee página a página el tema elegido y pide al modelo un resumen. Usa una cuenta de visor limitada a ese grupo para que el agente no pueda leer chats privados.
Una investigadora que archiva canales públicos de Telegram
Rastrear cuándo apareció por primera vez una afirmación en varios canales
Busca la frase en todos los chats archivados, lee cada resultado en contexto y compara fechas. Las ediciones y los borrados que guarda el archivo muestran si los posts cambiaron tras publicarse.
Antes de decidirte
- Puesta en marcha
- Pon primero en marcha Telegram Archive (Docker Compose, un api_id y un api_hash de Telegram y un inicio de sesión único). Después añade npx -y telegram-archive-mcp con TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_USER y TELEGRAM_ARCHIVE_PASS; hay configuraciones documentadas para Claude Code, Claude Desktop, Cursor, VS Code y Codex.
- Integraciones
- 12 herramientas y 4 recursos por stdio o Streamable HTTP, compatibles con las revisiones de MCP desde 2024-11-05 hasta 2026-07-28. Se distribuye como paquete npm que descarga un binario con suma de comprobación, como imagen Docker y como binarios de Go para varias plataformas.
- Datos y privacidad
- El archivo se queda en tu disco, pero cada mensaje, foto y estadística que devuelve una herramienta pasa a tu proveedor de modelos. El usuario y la contraseña del visor viven en el entorno del cliente. El modo HTTP se enlaza a loopback, comprueba Origin y exige MCP_AUTH_TOKEN en cualquier otra dirección.
- Coste a escala
- Gratuito. Los costes son el equipo que aloja el archivo y su almacenamiento, que crece con los medios que decidas guardar; Telegram Archive puede omitir archivos por encima de un tamaño que fijes.
- Límites
- Solo acceso de lectura; no puede enviar, editar ni borrar nada en Telegram. La calidad de la búsqueda depende de la búsqueda propia de Telegram Archive. Solo la última versión recibe correcciones de seguridad.
Lo bueno
- Nunca se conecta a Telegram; lee un archivo local
- Solo lectura salvo una herramienta de estadísticas, que READ_ONLY=1 oculta
- Lectura día a día y búsqueda en todos los chats
- El modo HTTP rechaza direcciones fuera de loopback sin token
Lo malo
- Necesita una instancia de Telegram Archive en marcha
- Los mensajes archivados y borrados llegan a tu proveedor de modelos
- Un solo mantenedor y pocos usuarios
- La contraseña del visor queda en la configuración del cliente
Ideal para
Quienes ya alojan Telegram Archive y quieren que un asistente busque y resuma sus chats guardados.
Alternativas a Telegram Archive MCP
Telegram Archive MCP: preguntas frecuentes
- ¿Merece la pena Telegram Archive MCP?
- Una ventana ordenada y casi totalmente de solo lectura a tu propio historial de Telegram, que merece la pena solo si ya usas Telegram Archive y aceptas que tus chats lleguen a un proveedor de modelos. Le damos un 3.8 sobre 5.
- ¿Cuánto cuesta Telegram Archive MCP?
- Gratuito y de código abierto (GPL-3.0-or-later), igual que Telegram Archive. Solo pagas la máquina que aloja el archivo.
- ¿Qué inconvenientes tiene Telegram Archive MCP?
- Necesita una instancia de Telegram Archive en marcha; los mensajes archivados y borrados llegan a tu proveedor de modelos; un solo mantenedor y pocos usuarios; la contraseña del visor queda en la configuración del cliente.
- ¿Para quién es Telegram Archive MCP?
- Quienes ya alojan Telegram Archive y quieren que un asistente busque y resuma sus chats guardados.
- ¿Cuánto cuesta Telegram Archive MCP para un equipo o en producción?
- Gratuito. Los costes son el equipo que aloja el archivo y su almacenamiento, que crece con los medios que decidas guardar; Telegram Archive puede omitir archivos por encima de un tamaño que fijes.
- ¿Es Telegram Archive MCP seguro para los datos de la empresa?
- El archivo se queda en tu disco, pero cada mensaje, foto y estadística que devuelve una herramienta pasa a tu proveedor de modelos. El usuario y la contraseña del visor viven en el entorno del cliente. El modo HTTP se enlaza a loopback, comprueba Origin y exige MCP_AUTH_TOKEN en cualquier otra dirección.
- ¿Cuáles son las mejores alternativas a Telegram Archive MCP?
- Las alternativas más cercanas que hemos analizado son Slack MCP Server y Paperless-NGX MCP Server.
Respuestas comprobadas el 13 nov 2026.