Advertise
MCP.so
Sign In

Telegram MCP Server

@bmwdroch

Repository

Basic information

Category

Communication

Last updated

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

atbridge.ai

atbridge-ai

Local MCP server for Thunderbird. Gives Claude Desktop, Cursor, or any MCP client read/write access to multiple mailboxes, calendars, contacts, notes & tasks (Gmail, Outlook, IMAP) — all on your machine.

ViewPrinter

VMGM Software

Schedule and publish social posts to TikTok, Instagram, Facebook, YouTube and X from your AI assistant. Connect an account once, then say what to post and when — ViewPrinter queues it, publishes it, and tells you what ha

Caulo

Patry

Caulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au

Tactiq

Search, read, and summarise meeting transcripts and summaries from Google Meet, Zoom, and Microsoft Teams - directly from Claude. Meetings as context: ask what was decided, who you spoke with, or what’s come up across an

Surgemesh

Novus Index LLC

Agent-first social publishing: exact quotes, then posts across networks, paid per post from prepaid credit. Remote MCP. Preview: quotes and sandbox posts now; live posts soon. By Novus Index LLC.

Advertise