Advertise
MCP.so
Sign In

Telegram MCP Server

@bmwdroch

Repository

Basic information

Category

Communication

Transports

stdio

Author

bmwdroch

About Telegram MCP Server

No overview available yet

#telegram#mcp#ai-integration

Telegram MCP Server config

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

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "npx",
      "args": [
        "-y",
        "server-perplexity-ask"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Telegram MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Telegram MCP Server?

Telegram MCP Server is an MCP (Model Context Protocol) server that integrates AI agents with Telegram. It allows agents to send messages to a user and wait for their reply in synchronous mode, enabling human-in-the-loop interactions.

How to use Telegram MCP Server?

Use it with MCP‑compatible IDEs (Cursor, WindSurf, VSCode with extensions) by adding the Docker container to your mcp_config.json, providing TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID. The server exposes the sendMessage tool, which you call from your AI agent to send a message and await a user response.

Key features of Telegram MCP Server

  • Send messages to Telegram users and wait for replies
  • Configurable timeout (600–3600 seconds)
  • Supports HTML, Markdown, or plain text message formatting
  • Synchronous mode – agent pauses until the user responds
  • Secure token and chat ID storage via environment variables
  • Ready‑to‑use Docker container for easy deployment

Use cases of Telegram MCP Server

  • AI agent asks for user approval before proceeding with a critical action
  • Automated workflow that requires human confirmation at a specific step
  • Virtual assistant that needs user clarification or additional input
  • Interactive task execution where the agent waits for user decisions

Frequently asked questions

1

What prerequisites are needed to use this server?

You need a Telegram bot token (create via [@BotFather](https://t.me/BotFather)), your personal chat ID (from [@userinfobot](https://t.me/userinfobot)), and Docker installed.

2

How do I configure Telegram MCP Server in my IDE?

Add a Docker‑based MCP server entry to your `mcp_config.json` file, setting `TELEGRAM_BOT_TOKEN` and `TELEGRAM_CHAT_ID` either as environment variables in the `env` block or via an `--env-file`.

3

What parameters does the `sendMessage` tool accept?

It requires `agentMessage` (the text to send). Optional parameters: `timeout` (seconds, 600–3600) and `parseMode` (HTML, Markdown, or null). It returns a JSON with `status`, `userResponse`, and `timestamp`.

4

Can I run the server without Docker?

The README shows only Docker‑based deployment (via Docker run or Docker Compose). No native Python or Node.js run instructions are provided.

5

Does Telegram MCP Server store any user data?

The README does not mention data storage. Tokens and chat IDs are provided as environment variables at runtime, and the server only relays messages between the agent and Telegram.

Comments

More Communication MCP servers

SendRaven

CommonNinja

SendRaven is email infrastructure for AI agents. Send, read replies as threads, run campaigns and automations, with limits on the API key.

1

Faxer

1771 Co

Send real faxes to any US, Canadian, or international fax number from any AI assistant. The agent quotes the exact price from the document's real page count, hands the human a Stripe Checkout link (payment stays human-in

Upfirst

Upfirst is an AI phone receptionist for small businesses. Review call transcripts, then fix the greeting, knowledge, and transfer rules from your AI client.

Mobile Text Alerts SMS

Mobile Text Alerts

Official Mobile Text Alerts server. Send and schedule SMS, manage subscribers and groups, and complete carrier registration from any MCP-compatible AI assistant.

Mektup-mcp

WeeCi

Mektup gives AI agents and their humans a real email mailbox, not just a one-way sending API. Through 41 MCP tools, an agent can register a domain, create a mailbox, send and receive mail, and manage threads, drafts, fol

Advertise