telegram-slack-mcp

Dale a Claude tus chats reales.

Dos servidores MCP que conectan Claude con tus cuentas personales de Telegram y Slack — sus DMs, grupos y canales reales, no una bandeja de entrada de un bot.

claude mcp add telegram -- npx -y telegram-slack-mcp telegram
claude mcp add slack    -- npx -y telegram-slack-mcp slack

Luego, simplemente habla:

"¿qué hay sin leer en Telegram de gente real?" "lee mis últimos 30 mensajes con Priya y redacta una respuesta" "busca en todos mis espacios de trabajo de Slack el postmortem del despliegue"

Por qué existe esto

La mayoría de las integraciones de Telegram usan el Bot API, que solo ve los mensajes enviados a un bot que hayas creado. No puede leer tus conversaciones existentes. telegram-slack-mcp utiliza MTProto, el mismo protocolo que usa la aplicación oficial, autenticándose como tú — así que Claude ve los chats que realmente tienes.

En el caso de Slack, el conector habitual está limitado a un solo espacio de trabajo. telegram-slack-mcp acepta un token de usuario por espacio de trabajo y los trata como una única superficie, de modo que "buscar en todas partes" significa en todas partes.

Related MCP server: google-chat-mcp

Instalación

Elige el runtime que ya tengas. Ambos incluyen las mismas herramientas.

Node

claude mcp add telegram -- npx -y telegram-slack-mcp telegram
claude mcp add slack    -- npx -y telegram-slack-mcp slack

Python

claude mcp add telegram -- uvx telegram-slack-mcp telegram
claude mcp add slack    -- uvx telegram-slack-mcp slack

Plugin de Claude Code

/plugin marketplace add nileshpatil6/telegram-slack-mcp
/plugin install telegram@telegram-slack-mcp
/plugin install slack@telegram-slack-mcp

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "telegram-slack-mcp", "telegram"],
      "env": { "TELEGRAM_API_ID": "1234567", "TELEGRAM_API_HASH": "your_hash" }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "telegram-slack-mcp", "slack"],
      "env": { "SLACK_USER_TOKENS": "xoxp-one,xoxp-two" }
    }
  }
}

Configuración

Telegram — 2 minutos

1. Entra en https://my.telegram.org → Herramientas de desarrollo de API → crea una aplicación.

2. Copia el api_id y el api_hash, y ajústalos:

   claude mcp add telegram \
     -e TELEGRAM_API_ID=1234567 \
     -e TELEGRAM_API_HASH=your_hash \
     -- npx -y telegram-slack-mcp telegram

3. Pide a Claude: "inicia sesión en Telegram, mi número es +91...". Claude llama a login_start, Telegram te envía un código, tú lo pegas y Claude llama a login_complete. Es la única vez que ocurre: la sesión se guarda en ~/.chat-mcp y persiste para siempre.

¿¿Tienes 2FA? Entrega a Claude tu contraseña de la nube de Telegram junto con el código.

Slack — 5 minutos

1. Ve a https://api.slack.com/apps → Crear Nueva App → Desde un manifiesto.

2. Pega slack-app-manifest.yaml: rellena automáticamente todos los scopes.

3. Instalar en el workspace, y copia el User OAuth Token (xoxp-…, no xoxb-).

4. Repite el paso 3 para cada espacio de trabajo que quieras. Misma app, un token por cada uno.

5. Configúralos todos a la vez, separados por comas:

   claude mcp add slack -e SLACK_USER_TOKENS=xoxp-aaa,xoxp-bbb -- npx -y telegram-slack-mcp slack

Herramientas

Telegram

Slack

Cada herramienta de Slack acepta un workspace opcional (cualquier subcadena del nombre). Déjalo en blanco para actuar sobre todos ellos; solo es necesario cuando un nombre de canal existe en más de un workspace, y el error te lo indica.

Configuración

El envío está desactivado por defecto en ambos servidores. La lectura es la opción segura; se opta por la escritura de forma deliberada.

Privacidad

No se envía nada a ningún servidor de este proyecto. No existe ese servidor.

telegram-slack-mcp se ejecuta completamente en tu máquina. El único tráfico de red que genera va directamente a las propias APIs de Telegram y Slack, usando tus credenciales. No hay telemetría, ni analíticas, ni informes de fallos, ni comprobación de licencias, ni «phone home»: haz grep del código fuente y no hay ningún endpoint que encontrar.

La ruta de los datos es exactamente esta:

your machine  <-->  Telegram / Slack APIs      (your credentials, your account)
your machine  <-->  Claude                     (only what you ask Claude to read)

Tus credenciales nunca llegan a Claude. Tu archivo de sesión y los tokens xoxp- permanecen en ~/.chat-mcp y en tu entorno; los servidores los usan localmente para hacer llamadas a la API y devuelven solo los mensajes mismos.

Lo que sí llega a Claude es el contenido de los chats sobre el que preguntas, porque esa es la finalidad de la herramienta. Si pides a Claude que lea una conversación, esa conversación va a tu conversación de Claude y se trata según la política de privacidad de Anthropic, igual que el texto que pegas tú mismo. No se lee nada más, y nada se lee en segundo plano: los servidores solo actúan cuando Claude llama a una herramienta.

El autor de este proyecto no puede ver nada de esto.

Seguridad

Lee esta parte.

• Actas como tú, no como un bot. Cualquier envío se muestra como si lo hubiera hecho tu cuenta, y la gente en esos chats no no puede diferenciarlo.

• The stored sesión cuenta completa. ~/.chat-mcp/telegram.session y tus tokens xoxp- sonmales a haber iniciado sesión como tú. Cualquiera que los copie tendrá tu cuenta. Nunca salen de tu máquina, y nada aquí «llama a casa».

• Todo lo que Claude lee entra en el contexto del modelo. No apuntes esto a cuentas que contengan datos que no enviarías a un modelo.

• Telegram llama a esto 'userbot', un robot de usuario. Automatizar una cuenta personal está limitado por las condiciones de servicio de Telegram. El uso personal y ligero para leer y responder es habitual y de bajo riesgo; la automatización masiva hace que se bloqueen cuentas. Tú decides, tu cuenta.

• Revócalo en cualquier momento: en Telegram → Ajustes → Dispositivos, o borra el token en los ajustes de la aplicación de Slack. Eliminar ~/.chat-mcp destruye la sesión local.

Solución de problemas

"Telegram not logged in yet" — ejecuta el flujo de inicio de sesión: pide a Claude que se sugere con tu número de teléfono. A partir de ahí persiste; si sigue apareciendo, comprueba que CHAT_MCP_DATA_DIR es escribible.

"Missing Telegram credentials" : TELEGRAM_API_ID / TELEGRAM_API_HASH acuerdan al servidor. Con claude mcp add, pásalos con -e.

Slack returns nothing at all — seguro que la autorización se ha hecho contra un workspace vacío o equivocado. Ejecuta whoami para ver qué workspaces hay realmente conectados.

"#general" exists in several workspaces — pasa workspace para desambiguar; el errors lists tus opciones.

Slack search returns not_allowed_token_type — el token es un token de bot (xoxb-). Debes usar el token User OAuth (xoxp-).

Desarrollo

git clone https://github.com/nileshpatil6/telegram-slack-mcp
cd telegram-slack-mcp
npm install && npm run build
node dist/cli.js telegram        # run the server on stdio

cd python && python -m build     # build the Python distribution

Licencia

MIT