Repolode
chigwell

chigwell/telegram-mcp

Servidor MCP basado en Telethon que permite a clientes de IA como Claude y Cursor leer chats de Telegram y gestionar grupos, mensajes, archivos multimedia y contactos.

Estrellas
1,850
Forks
470
Issues abiertos
31
Último commit
hace 23 horas

¿Qué es?

Telegram MCP Server es una integración que ofrece operaciones de cuentas de Telegram, chats, mensajes, contactos, archivos multimedia, carpetas y administración a clientes compatibles con MCP, como Claude Desktop y Cursor. Está basado en Telethon y ofrece más de 80 herramientas para gestionar chats y grupos, mensajes (enviar, editar, reenviar, buscar, encuestas y reacciones), contactos, archivos multimedia, ajustes del perfil y de privacidad, y carpetas de Telegram.

El servidor admite varias cuentas, a las que se dirige mediante etiquetas, y puede limitarse a un conjunto de herramientas de solo lectura o a una lista de chats permitidos. Puede ejecutarse mediante stdio, HTTP transmisible o SSE, e incluye transcripción opcional de mensajes de voz mediante Groq, Telegram Premium, endpoints compatibles con OpenAI o un modelo local de faster-whisper. Las sesiones se pueden almacenar como cadenas o en archivos SQLite persistentes, y admite proxies SOCKS, HTTP y MTProxy.

Enviar y modificar mensajes mediante un agente de IA conlleva riesgos reales, por lo que el proyecto ofrece controles como el modo de solo lectura, listas de extensiones de archivo permitidas y directorios raíz autorizados para acceder a archivos.

Funciones clave

  • 01Ofrece más de 80 herramientas MCP para chats, grupos, mensajes, contactos, archivos multimedia y carpetas.
  • 02Admite varias cuentas de Telegram, a las que se dirige mediante etiquetas.
  • 03Ofrece un modo de solo lectura y listas de herramientas permitidas para limitar las operaciones de escritura.
  • 04Transcribe mensajes de voz mediante Groq, Telegram Premium, APIs compatibles con OpenAI o Whisper local.
  • 05Funciona mediante transportes stdio, HTTP transmisible o SSE.
  • 06Admite proxies SOCKS, HTTP y MTProxy.

Casos de uso

  • Permitir que Claude o Cursor resuman mensajes de Telegram sin leer y redacten respuestas.
  • Buscar en el historial de chats y obtener contexto para un asistente de IA.
  • Automatizar tareas de administración de grupos, como invitaciones, permisos y bloqueos.
  • Compartir un servidor de Telegram entre varias sesiones de agentes de programación mediante HTTP.

Inicio rápido

  1. 1

    Clona el repositorio

  2. 2

    Instala las dependencias con uv

    uv sync
  3. 3

    Ejecuta el servidor

Antes de usarlo

  • Se necesita un ID y un hash de la API de Telegram; algunas funciones también requieren Telegram Premium.
  • Varios motores de transcripción y el formato avanzado dependen de servicios de pago o que requieren una clave de API.

Temas

Preguntas frecuentes

¿Qué es telegram-mcp?
Servidor MCP basado en Telethon que permite a clientes de IA como Claude y Cursor leer chats de Telegram y gestionar grupos, mensajes, archivos multimedia y contactos. Telegram MCP Server es una integración que ofrece operaciones de cuentas de Telegram, chats, mensajes, contactos, archivos multimedia, carpetas y administración a clientes compatibles con MCP, como Claude Desktop y Cursor. Está basado en Telethon y ofrece más de 80 herramientas para gestionar chats y grupos, mensajes (enviar, editar, reenviar, buscar, encuestas y reacciones), contactos, archivos multimedia, ajustes del perfil y de privacidad, y carpetas de Telegram.
¿telegram-mcp es gratuito? ¿Qué licencia tiene?
telegram-mcp es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿telegram-mcp sigue mantenido?
Mantenimiento activo. El último commit de telegram-mcp fue el 19 oct 2026.
¿Para qué puedo usar telegram-mcp?
Permitir que Claude o Cursor resuman mensajes de Telegram sin leer y redacten respuestas. Buscar en el historial de chats y obtener contexto para un asistente de IA. Automatizar tareas de administración de grupos, como invitaciones, permisos y bloqueos. Compartir un servidor de Telegram entre varias sesiones de agentes de programación mediante HTTP.
¿Cómo se instala telegram-mcp?
Clona el repositorio Instala las dependencias con uv: uv sync Ejecuta el servidor
¿Dónde consigo telegram-mcp?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/chigwell/telegram-mcp

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados