T

Telegram MCP

Send and receive Telegram messages via the Bot API.

Telegram·No reviews yet
Repo Docs
Share:

About

Interact with the Telegram Bot API to send messages, files, and rich media to channels, groups, or direct conversations. Supports inline keyboards, callback queries, and long-polling for incoming updates. Perfect for personal notification agents, alerting pipelines, and multi-channel assistants.

Example tools

Illustrative tool names — the actual tool set is defined by the server at runtime.

send_message
Post a message to a channel or user
list_channels
List channels the bot can access
search_messages
Search messages by query and date range

Screenshots

No screenshots yet.

Frequently Asked Questions

Common questions about Telegram MCP.

What is the Telegram MCP used for?
The Telegram MCP allows you to interact with the Telegram Bot API. You can send messages, files, and rich media to various Telegram chats. It also supports receiving updates via long-polling.
How do I configure this MCP in a client like Claude Desktop?
Configuration typically involves providing the MCP's slug ('telegram') and an API key. You would add a new MCP connection in your client's settings and input these details. Specific steps may vary by client version.
Does the Telegram MCP require an API key for authentication?
Yes, authenticating with the Telegram Bot API requires an API key. This key is provided by Telegram when you create a new bot via BotFather.
What are the key capabilities of the Telegram MCP?
This MCP enables sending various message types, managing inline keyboards, handling callback queries, and receiving incoming updates via long-polling. It's suitable for notifications and multi-channel assistance.
What is a prerequisite for using the Telegram MCP?
A prerequisite for using the Telegram MCP is having a Telegram bot and its associated API key. This bot is created and managed through Telegram's BotFather service.
Is there a cost associated with using the Telegram MCP?
The Telegram MCP itself is provided under an open-source license. The underlying Telegram Bot API service is free for typical usage, but specific terms and limitations are governed by Telegram.

Install Telegram MCP

Claude Desktop

Add this to claude_desktop_config.json.

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-telegram"
      ]
    }
  }
}

Cursor

Add this to ~/.cursor/mcp.json.

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-telegram"
      ]
    }
  }
}

VS Code

Add this to your workspace settings.json.

{
  "mcp.servers": {
    "telegram": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-telegram"
      ]
    }
  }
}

Reviews

Sign in to leave a review.

No reviews yet. Be the first!

Discussion(0)

Sign in to join the discussion.

No comments yet.