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

uplika

uplika

Hosted MCP server that lets your AI agent post to Threads, Instagram, YouTube, Facebook, TikTok, Pinterest, Bluesky, Telegram, Discord, Ghost and Naver Blog. Setup for each agent.

HelpWell

Workado, LLC

HelpWell connects AI assistants to your help desk, knowledge base, live chat support and email marketing automation for SaaS. Triage support tickets, draft help docs and replies, manage contacts, and prepare newsletters

S

Summer

Summer

Telehealth support for Claude, Codex and Cursor. Investigate stuck orders and billing issues, review case evidence, connect your tools and prepare next steps with Summer.

call4me

Nick Khami

call4me lets your AI agent make real phone calls for you. Ask Claude, ChatGPT, Cursor, Codex or your own app to book a table, schedule a dentist appointment, cancel a subscription or ask a business a question. It calls,

Canarics

Canarics

AI call analysis and voice agents for sales teams. This MCP server lets a team's own AI assistant read minute usage, agents, call summaries and daily stats, look up caller history, schedule consent-gated AI callbacks, an

Advertise