telegram-bot-mcp
Allows sending messages, documents, photos, polls, and alerts to Telegram chats and channels using the official Telegram Bot API, including rich text formatting and interactive buttons.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
# Telegram Bot MCP Server
Servidor MCP (Model Context Protocol) autónomo en TypeScript diseñado para la distribución automatizada de contenido para YouTube, entrega instantánea de Lead Magnets (workflows de n8n, código y guías), encuestas interactivas comunitarias y alertas móviles directas a tu celular, operando a coste $0.00 de por vida mediante la Telegram Bot API oficial.
🎯 ¿Por qué usar Telegram Bot MCP en YouTube y Desarrollo?
Dominar la "Golden Hour" de YouTube: Los primeros 60 minutos tras publicar un vídeo deciden la recomendación algorítmica. Telegram entrega notificaciones push instantáneas con una tasa de apertura superior al 75% (frente al 15% del email marketing).
Descarga en 1 Clic del Lead Magnet: Envía directamente a tu canal de suscriptores el archivo de flujo
.jsonde n8n o scripts de código, aumentando drásticamente la conversión de espectadores a comunidad VIP.Validación Temática Pre-Grabación: Lanza encuestas interactivas (
telegram_send_poll) para que tus suscriptores voten el tema del próximo vídeo.DevOps y Alertas a tu Teléfono: Recibe notificaciones push en tu propio chat privado cuando terminen procesos en segundo plano (transcripciones de
faster-whisper-mcp, alertas de analítica o errores en webhooks).
Related MCP server: telegram-mcp
🛠️ Stack Tecnológico
Runtime: Node.js 20+ con soporte nativo de TypeScript (
--experimental-strip-types)Protocolo: Model Context Protocol SDK (
@modelcontextprotocol/sdk)API: Telegram Bot API oficial (HTTP/HTTPS nativo con
fetchyFormData)Variables de Entorno:
dotenv
📋 Requisitos Previos (Obtener Token de Bot en 1 minuto)
Abre la aplicación de Telegram y busca al bot oficial @BotFather.
Envía el comando
/newbot.Asigna un nombre a tu bot (ej: Ramiro Medina Community Bot) y un usuario (ej: RamiroMedinaAIBot).
@BotFatherte entregará tu Bot Token (ej:7123456789:AAH...).Añade tu bot como Administrador en tu canal o grupo de Telegram con permisos para publicar mensajes.
⚙️ Instalación y Configuración
1. Clonar o descargar el repositorio
git clone https://github.com/ramedina-ia/telegram-bot-mcp.git
cd telegram-bot-mcp2. Instalar dependencias
npm install3. Configurar variables de entorno
Copia la plantilla .env.example a .env:
cp .env.example .envEdita .env con tus credenciales:
# Token oficial de @BotFather
TELEGRAM_BOT_TOKEN=tu_token_aqui
# ID de tu canal oficial (ej: @TuCanal o -100123456789)
TELEGRAM_DEFAULT_CHAT_ID=@TuCanal
# Tu ID personal de usuario en Telegram para recibir alertas en tu móvil
TELEGRAM_ADMIN_CHAT_ID=123456789🔌 Integración en Google Antigravity
Agrega el servidor en ~/.gemini/antigravity/mcp_config.json:
{
"mcpServers": {
"telegram-bot-mcp": {
"command": "cmd.exe",
"args": [
"/c",
"d:\\Respaldo Informacion NO BORRAR\\Desktop\\Proyectos Antigravity\\Estudio analiticas y rendimiento You Tube\\telegram-bot-mcp\\run.cmd"
]
}
}
}🧰 Catálogo de Herramientas MCP
Herramienta | Descripción | Parámetros Clave |
| Envía texto enriquecido con formato HTML/Markdown y botones inline clicables. |
|
| Sube y envía archivos locales ( |
|
| Envía imágenes de alta resolución o miniaturas desde archivo local o URL. |
|
| Publica encuestas interactivas con entre 2 y 10 opciones de votación. |
|
| Alerta optimizada de YouTube: gancho, botones de YouTube/WhatsApp y adjunta el JSON de n8n. |
|
| Notificación directa de telemetría a tu teléfono móvil personal. |
|
| Diagnóstico: verifica el estado del bot y devuelve nombre y | Ninguno |
💬 Prompts de Ejemplo para Antigravity
Acabo de publicar un nuevo vídeo en YouTube sobre n8n. Envía una alerta oficial a mi canal de Telegram adjuntando el archivo de flujo
workflow_lead_gen.jsony los botones interactivos.Lanza una encuesta en Telegram para que la comunidad vote si el próximo tutorial debe ser de Gemini 3.8 Flash o de Agentes en Supabase.
Envíame una alerta a mi celular cuando la transcripción de Faster-Whisper haya terminado.
🔒 Seguridad y Privacidad
Sin credenciales expuestas: Toda comunicación con la API se autentica mediante variables en
.env.Aislamiento
.gitignore: Excluye.env,node_modules/,dist/y archivos de log.Sin intermediarios: Comunicación directa mediante HTTPS con
api.telegram.org.
📄 Licencia
Distribuido bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Telegram automation: channel feed with summaries, digests and auto-publishing.
Let AI assistants post to your Telegram chats, groups and channels. Not affiliated with Telegram.
Run a Telegram channel from your AI agent. Posts go out through your own bot, not your account.
Telegram: FASTEST real time Telegram API. Retrieve channel's info and messages in milliseconds..
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to send and receive messages, media, and files on Telegram, and manage chats via a bot token.1771 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to send notifications and receive responses via Telegram.58 npm4MIT
- AlicenseBqualityDmaintenanceEnables AI agents to send notifications and media (text, photos, documents, videos) via a Telegram bot.4138 npm4Do What The F*ck You Want To Public
- AlicenseNot gradedqualityDmaintenanceEnables communication with users through Telegram, including asking questions, sending notifications, sharing files, and creating project archives via a bot.595 npmISC