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.
Telegram MCP Server
@bmwdroch
Basic information
About Telegram MCP Server
No overview available yet
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
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`.
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`.
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.
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.
More Communication MCP servers
DashaMail
DashaMailMCP server for DashaMail email marketing service
Canarics
CanaricsAI 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
R
RelayLink
RelayLink lets your AI assistant send briefings to other people's AI assistants. Draft a package from your current conversation, attach files, approve the note, and the recipient's AI gets the full context: decisions, op
Surgemesh
Novus Index LLCAgent-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.
gtm-api
gtm-apiMCP server and API for AI agents that work LinkedIn on accounts you own: search, connect, message and enrich, with limits enforced on our server.
Comments