mcpField
T
Telegram MCP Server

Telegram MCP Server

Local
github.com/abhinavkale-devCommunication5Updated 80w ago
Repository

About Telegram MCP Server

Telegram MCP Server lets AI assistants interact with Telegram through the Telegram Bot API. Its supported operations cover sending text and photos, and deleting messages.

Key features

  1. 01Send text messages to chats
  2. 02Send photos with optional captions
  3. 03Delete messages

Use cases

  1. 01Send a Telegram update from an AI assistant
  2. 02Share a photo with a chat
  3. 03Remove a message from a chat

MCP support

The server exposes Telegram Bot API operations as standardized tools for MCP-compatible clients. It requires a Telegram bot token.

#mcp-server#modelcontextprotocol

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Telegram MCP Server

A Model Context Protocol server for the Telegram Bot API, allowing AI assistants to interact with Telegram using standardized tools.

Setup

  1. Install dependencies:

    npm install

  2. Create a .env file with your Telegram Bot Token:

    TELEGRAM_BOT_TOKEN=your_bot_token_here

  3. Build the TypeScript project:

    npm run build

  4. Start the server:

    npm start

MCP Client Configuration

To use this server with an MCP client, add the following configuration to your MCP client's config file:

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

Supported Operations

The Telegram MCP server supports the following operations:

  • sendMessage: Send a text message to a chat
  • sendPhoto: Send a photo with optional caption to a chat
  • deleteMessage: Delete a message from a chat

Usage Example

The server implements the Model Context Protocol, so it can be used with any MCP-compatible client. Here are some example call formats:

Send a message :
{
  "operation": "sendMessage",
  "chatId": 123456789,
  "text": "Hello from the Telegram MCP Server!"
}
Send a photo :
{
  "operation": "sendPhoto",
  "chatId": 123456789,
  "photoUrl": "https://example.com/image.jpg",
  "caption": "Check out this photo!"
}
Delete a message :
{
  "operation": "deleteMessage",
  "chatId": 123456789,
  "messageId": 987654321
}

Implementation Details

This server uses:

  • The Model Context Protocol SDK
  • Telegram Bot API
  • TypeScript

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.