Telegram MCP Server

Name: Telegram MCP Server
Author: bmwdroch

@bmwdroch

リポジトリ

Telegram MCP Server について

概要はまだありません

#telegram #mcp #ai-integration

基本情報

カテゴリ

コミュニケーション

ランタイム

python

トランスポート

stdio

公開者

bmwdroch

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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

FAQ from Telegram MCP Server

What prerequisites are needed to use this server?

You need a Telegram bot token (create via @BotFather), your personal chat ID (from @userinfobot), and Docker installed.

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.