MCP Catalogs
← Home

telegram-mcp-server

by abhinavkale-dev·★ 4·Score 30

A Model Context Protocol server enabling AI assistants to interact with Telegram through standardized tools.

communicationdeveloper-tools
2
Forks
0
Open issues
13 mo ago
Last commit
2d ago
Indexed

Overview

The telegram-mcp-server is a TypeScript-based implementation that bridges AI assistants with Telegram's Bot API. It provides standardized tools for sending text messages, photos, and deleting messages within Telegram chats, following the Model Context Protocol specification. The server is well-documented with clear setup instructions and configuration examples.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Automating customer support responses through Telegram
you:Creating AI-powered notification systems for Telegram groups
you:Building custom Telegram bots with AI capabilities
you:What operations does the Telegram MCP server support?
you:How do I get a Telegram Bot Token?

When to choose this

Choose this when you need basic Telegram integration for AI assistants and want a simple, protocol-based solution without complex setup.

When NOT to choose this

Don't choose this if you need advanced Telegram features like group management, file uploads beyond photos, or require more robust error handling.

Tools this server exposes

3 tools extracted from the README
  • sendMessagesendMessage(chatId, text)

    Send a text message to a Telegram chat

  • sendPhotosendPhoto(chatId, photoUrl, caption)

    Send a photo with optional caption to a Telegram chat

  • deleteMessagedeleteMessage(chatId, messageId)

    Delete a message from a Telegram chat

Comparable tools

telegraph-mcpmcp-server-telegramnode-telegram-bot-api

Installation

Installation

  1. Install dependencies:
npm install
  1. Create a .env file with your Telegram Bot Token:
TELEGRAM_BOT_TOKEN=your_bot_token_here
  1. Build the TypeScript project:
npm run build
  1. Start the server:
npm start

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["path/to/telegram-mcp-server/dist/telegram-mcp.js"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_bot_token_here"
      }
    }
  }
}

FAQ

What operations does the Telegram MCP server support?
The server supports three operations: sendMessage, sendPhoto, and deleteMessage.
How do I get a Telegram Bot Token?
Create a new bot by messaging @BotFather on Telegram and follow the instructions to generate a token.

Compare telegram-mcp-server with

telegram-mcp-server vs mcp-server-charttelegram-mcp-server vs everythingtelegram-mcp-server vs filesystemtelegram-mcp-server vs timetelegram-mcp-server vs sequentialthinking
GitHub →

Last updated · Auto-generated from public README + GitHub signals.