MCP.so
Sign In

Telegram MCP Server

@abhinavkale-dev

About Telegram MCP Server

Simple Telegram MCP server

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Telegram MCP Server?

A Model Context Protocol server for the Telegram Bot API, allowing AI assistants to interact with Telegram using standardized tools. It implements the MCP SDK and exposes Telegram operations as callable tools.

How to use Telegram MCP Server?

Install dependencies with npm install, create a .env file with your TELEGRAM_BOT_TOKEN, build with npm run build, and start with npm start. For MCP client integration, add the provided JSON configuration to your client's config file, specifying the server path and bot token.

Key features of Telegram MCP Server

  • Send text messages to any chat
  • Send photos with optional captions
  • Delete messages from a chat
  • Works with any MCP-compatible client

Use cases of Telegram MCP Server

  • An AI assistant sends notifications to a Telegram group
  • A bot sends photos with captions to users
  • Automated message cleanup by deleting old messages

FAQ from Telegram MCP Server

How do I set up the Telegram MCP Server?

Follow the setup steps: install dependencies, create a .env file with your TELEGRAM_BOT_TOKEN, build the TypeScript project, and start the server.

What operations does it support?

It supports three operations: sendMessage, sendPhoto, and deleteMessage. Each takes the required parameters as shown in the usage examples.

How do I use it with an MCP client?

Add the provided JSON configuration to your MCP client’s config file, specifying the server’s JavaScript file path and your Telegram bot token in the env field.

What is required to run the Telegram MCP Server?

You need Node.js, the npm dependencies from npm install, and a valid Telegram Bot Token stored in the TELEGRAM_BOT_TOKEN environment variable.

Frequently asked questions

How do I set up the Telegram MCP Server?

Follow the setup steps: install dependencies, create a `.env` file with your `TELEGRAM_BOT_TOKEN`, build the TypeScript project, and start the server.

What operations does it support?

It supports three operations: `sendMessage`, `sendPhoto`, and `deleteMessage`. Each takes the required parameters as shown in the usage examples.

How do I use it with an MCP client?

Add the provided JSON configuration to your MCP client’s config file, specifying the server’s JavaScript file path and your Telegram bot token in the `env` field.

What is required to run the Telegram MCP Server?

You need Node.js, the npm dependencies from `npm install`, and a valid Telegram Bot Token stored in the `TELEGRAM_BOT_TOKEN` environment variable.

Comments

More Communication MCP servers