de en es ja ko ru zh

telegram-mcp-server

Name: telegram-mcp-server
Author: Steph-ux

by Steph-ux

Overview Schema Related Servers Score Discussions

Python

Remote

telegram-mcp-server

Un servidor MCP de Telegram mediante Telethon — cliente persistente, seguro contra flooding, 9 herramientas agrupadas.

Cero claves API en el código. Los archivos de sesión se almacenan localmente. Funciona con cuentas de usuario (2FA) y bots.

1. Instalación

git clone <this-repo> telegram-mcp-server
cd telegram-mcp-server

python -m venv .venv
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate

pip install -e .

Obtén tus credenciales API

Ve a my.telegram.org
Inicia sesión con tu número de teléfono
Crea una aplicación → obtén tu API ID y API Hash

Autenticación única

# User account (with 2FA support)
export TG_API_ID=12345
export TG_API_HASH="your_hash_here"
telegram-mcp-server --auth --phone +33612345678

# Or via MCP tool: tg_session(action="auth", api_id=12345, api_hash="...", phone="+33612345678")

Related MCP server: tdlib-mcp-server

2. Regístrate en tu cliente MCP

Claude Desktop / OpenCode

{
  "mcpServers": {
    "telegram": {
      "command": "telegram-mcp-server",
      "env": {
        "TG_API_ID": "12345",
        "TG_API_HASH": "your_hash_here"
      }
    }
  }
}

Si no está en el PATH:

{
  "mcpServers": {
    "telegram": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "telegram_mcp_server"],
      "env": {
        "TG_API_ID": "12345",
        "TG_API_HASH": "your_hash_here"
      }
    }
  }
}

Docker

docker build -t telegram-mcp .
docker run -i --rm \
  -v ~/.telegram-mcp/sessions:/root/.telegram-mcp/sessions \
  -e TG_API_ID=12345 \
  -e TG_API_HASH="your_hash" \
  telegram-mcp

3. Catálogo de herramientas (9 herramientas, 8 acciones)

`tg_session` — Gestión de sesión

action	Required args	Description
`auth`	`api_id`, `api_hash`, `phone` or `bot_token`	Autenticar (soporta 2FA)
`check`	—	Comprobar estado de sesión
`logout`	—	Eliminar sesión

`tg_message` — Enviar, reenviar, eliminar, responder

action	Required args	Description
`send`	`target`, `text`	Enviar un mensaje
`forward`	`target`, `message_id`, `to_target`	Reenviar un mensaje
`delete`	`target`, `message_id`	Eliminar un mensaje
`reply`	`target`, `message_id`, `text`	Responder a un mensaje

`tg_chat` — Operaciones de chat

action	Required args	Description
`list`	—	Listar chats recientes
`info`	`target`	Obtener información del chat
`members`	`target`	Listar miembros del chat
`leave`	`target`	Salir de un chat

`tg_search` — Búsqueda

action	Required args	Description
`messages`	`query`	Buscar mensajes (opcionalmente en `target`)
`users`	`query`	Buscar contactos/usuarios
`channels`	`query`	Buscar canales

`tg_history` — Historial de chat

action	Required args	Description
`messages`	`target`	Obtener historial de mensajes
`media`	`target`	Obtener historial solo de medios
`files`	`target`	Obtener historial solo de archivos

`tg_user` — Operaciones de usuario

action	Required args	Description
`me`	—	Obtener tu propia información
`info`	`target`	Obtener información del usuario
`block`	`target`	Bloquear un usuario
`unblock`	`target`	Desbloquear un usuario

`tg_media` — Enviar medios

action	Required args	Description
`send_photo`	`target`, `file_path`	Enviar una foto
`send_video`	`target`, `file_path`	Enviar un video
`send_file`	`target`, `file_path`	Enviar un documento
`send_voice`	`target`, `file_path`	Enviar una nota de voz

`tg_channel` — Gestión de canales

action	Required args	Description
`create`	`title`	Crear un supergrupo/canal
`join`	`target`	Unirse a un canal
`leave`	`target`	Salir de un canal
`info`	`target`	Obtener información del canal

`tg_draft` — Mensajes borrador

action	Required args	Description
`save`	`target`, `text`	Guardar un borrador
`list`	—	Listar borradores
`delete`	`target`	Eliminar un borrador

4. Variables de entorno

Variable	Default	Description
`TG_API_ID`	`0`	ID de API de Telegram (de my.telegram.org)
`TG_API_HASH`	`""`	Hash de API de Telegram
`TG_SESSION_DIR`	`~/.telegram-mcp/sessions`	Ubicación de los archivos de sesión

5. Seguridad

Límite de frecuencia: Las acciones de envío están limitadas a 5/min. Las acciones de lectura son ilimitadas.
Reintento automático de FloodWaitError: Espera el tiempo requerido (máximo 5 minutos).
Archivos de sesión: Solo locales, nunca se incluyen en git.
Soporte 2FA: Compatibilidad total con cuentas con autenticación de dos factores.

6. Recursos MCP

tg://version — Versión del servidor
tg://session/status — Estado de sesión

Licencia

MIT

This server cannot be installed

license - not found

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Telegram MCP Server
Communication Social Media
shaxzodrashid
F
license
A
quality
B
maintenance
Enables AI agents to interact with Telegram via MTProto, supporting high-performance communication and seamless integration.
Updated a month ago (2026-07-23 20:34 UTC)
1
tdlib-mcp-server
Communication Search
Crocodile-beep
F
license
Not graded
quality
C
maintenance
Connects AI agents to Telegram via the official TDLib library, enabling tools like getting user info, listing dialogs, and searching messages.
Updated 2 months ago (2026-06-08 16:35 UTC)
telegram-mcp
Communication
chenzhaoxuan0
A
license
Not graded
quality
C
maintenance
Enables interaction with Telegram Bot API for sending messages, photos, editing messages, answering callbacks, and fetching updates.
Updated 2 months ago (2026-06-18 07:53 UTC)
MIT
Telegram Bot MCP Server
Communication App Automation
mattleads
A
license
Not graded
quality
B
maintenance
Enables sending Telegram messages, photos, and documents, and retrieving bot information through the Telegram Bot API.
Updated 4 months ago (2026-04-08 19:58 UTC)
58
1
MIT

View all related MCP servers

Related MCP Connectors

fast-mcp-telegram
Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API
telegram-mcp
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
tgden — Telegram catalog & search
Search 1.2M+ Telegram channels, 245k+ chats, 160k+ bots — no account, no key, no install.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Steph-ux/telegram-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

telegram-mcp-server

1. Instalación

Obtén tus credenciales API

Autenticación única

2. Regístrate en tu cliente MCP

Claude Desktop / OpenCode

Docker

3. Catálogo de herramientas (9 herramientas, 8 acciones)

tg_session — Gestión de sesión

tg_message — Enviar, reenviar, eliminar, responder

tg_chat — Operaciones de chat

tg_search — Búsqueda

tg_history — Historial de chat

tg_user — Operaciones de usuario

tg_media — Enviar medios

tg_channel — Gestión de canales

tg_draft — Mensajes borrador

4. Variables de entorno

5. Seguridad

6. Recursos MCP

Licencia

Maintenance

Resources

Looking for Admin?

Related MCP Servers