Which integrations are available for this server?

Allows interaction with the Telegram Bot API, enabling sending messages, editing/deleting messages, managing chats (ban, unban, pin), sending photos and documents, and retrieving bot info.

How do I use telegram-mcp-kit?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@telegram-mcp-kit send a message saying 'Hello everyone'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

telegram-mcp-kit

by QuocTang

Overview Schema Related Servers Score Discussions

Python

Hybrid

🚀 telegram-mcp-kit

MCP server that exposes the Telegram Bot API as tools for Claude Code (or any MCP client).

Related MCP server: telegram-bot-mcp

🚀 Quick Start

Get your bot token from @BotFather on Telegram. Once the server is configured, you can run /mcp inside Claude Code to verify it is connected.

🛠️ Installation

Get your bot token from @BotFather on Telegram first.

Option 1: From PyPI (recommended)

claude mcp add telegram-mcp-kit \
  -e TELEGRAM_BOT_TOKEN=your-bot-token-here \
  -e TELEGRAM_CHAT_ID=your-chat-id \
  -- uvx telegram-mcp-kit

{
  "mcpServers": {
    "telegram-mcp-kit": {
      "command": "uvx",
      "args": ["telegram-mcp-kit"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-bot-token-here",
        "TELEGRAM_CHAT_ID": "your-chat-id"
      }
    }
  }
}

Option 2: From GitHub

claude mcp add telegram-mcp-kit \
  -e TELEGRAM_BOT_TOKEN=your-bot-token-here \
  -e TELEGRAM_CHAT_ID=your-chat-id \
  -- uvx --from "git+https://github.com/QuocTang/telegram-mcp-kit.git" telegram-mcp-kit

{
  "mcpServers": {
    "telegram-mcp-kit": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/QuocTang/telegram-mcp-kit.git",
        "telegram-mcp-kit"
      ],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-bot-token-here",
        "TELEGRAM_CHAT_ID": "your-chat-id"
      }
    }
  }
}

Option 3: From source

git clone https://github.com/QuocTang/telegram-mcp-kit.git
cd telegram-mcp-kit
cp .env.example .env   # add your TELEGRAM_BOT_TOKEN
uv sync

claude mcp add telegram-mcp-kit \
  -- uv run --directory /absolute/path/to/telegram-mcp-kit telegram-mcp-kit

{
  "mcpServers": {
    "telegram-mcp-kit": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/telegram-mcp-kit",
        "telegram-mcp-kit"
      ]
    }
  }
}

With this option, TELEGRAM_BOT_TOKEN is read from the .env file inside the project directory.

Environment variables

Variable	Required	Description
`TELEGRAM_BOT_TOKEN`	Yes	Token from BotFather
`TELEGRAM_CHAT_ID`	No	Default chat ID (if set, `chat_id` can be omitted in tool calls)
`MCP_TRANSPORT`	No	`stdio` (default) or `sse`
`MCP_HOST`	No	Bind host (default `127.0.0.1`)
`MCP_PORT`	No	Bind port (default `8000`)
`HTTP_TIMEOUT`	No	Telegram API timeout in seconds (default `30`)

📦 Features

🚀 Feature	📝 Description
🛠️ 20+ Tools	Comprehensive coverage for messages, chat management, files/photos, and bot info.
🔍 Auto-discovery	Simply add a Python file to the `tools/` folder and it registers automatically.
📡 Flexible Transport	Works seamlessly over stdio (for local clients) or SSE (remote/Docker).

Tools List

Messages

Tool	Description
`send_message`	Send a text message (Markdown/HTML)
`edit_message`	Edit an existing message
`delete_message`	Delete a message
`forward_message`	Forward a message between chats

Updates

Tool	Description
`get_updates`	Fetch recent messages/updates the bot received

Chat management

Tool	Description
`get_chat_info`	Get chat metadata (name, type, description)
`get_chat_member_count`	Count members
`get_chat_admins`	List administrators
`ban_member`	Ban a user
`unban_member`	Unban a user
`set_chat_title`	Change group/channel title
`set_chat_description`	Change group/channel description
`pin_message`	Pin a message
`unpin_message`	Unpin a message

Files & photos

Tool	Description
`send_photo`	Send a photo by URL or file_id
`send_photo_file`	Send a local photo file
`send_document`	Send a document by URL or file_id
`send_document_file`	Send a local file as document
`get_file_info`	Get file metadata + download link

Bot

Tool	Description
`get_bot_info`	Get bot name, username, etc.

🤝 How to Contribute

We welcome contributions! Please follow these steps:

Fork the repository.
Create a new branch for your feature.
Submit a Pull Request.

See CONTRIBUTING.md for how to add new tools.

Development

uv sync                        # install all deps (including dev)
uv run pytest -v               # run tests
uv run ruff check src/ tests/  # lint

💬 Community & Support

If this repository saves you time, please star the repository!

👥 Repo Contributors

Made with contrib.rocks.

⚖️ License

MIT License. See LICENSE for details.

🌟 Star History

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/QuocTang/telegram-mcp-kit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server