Connector guide3-minute read13 MCP toolsEN · DE · IT

How to Connect Telegram Bot to Claude — via MCP

Send Telegram messages, photos, documents, audio, location and polls from any AI agent via the Telegram Bot API. 14 tools, bot-token auth. Outbound + lightweight read of recent updates (no long-polling).

HCBy HelpCode teamUpdated 3 min read Open source on GitHub

No credit card · 7-day trial · Self-host alternative available

Telegram Bot

MCP connector

Telegram Bot

Send Telegram messages, photos, documents, audio, location and polls from any AI agent via the Telegram Bot API. 14 tools, bot-token auth. Outbound + lightweight read of recent updates (no long-polling).

Tools

13

Region

INTL

Category

Messaging

Authentication

Public API

Required env vars

TELEGRAM_BOT_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the Telegram Bot in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

Summary

Send Telegram messages, photos, documents, audio, location and polls from any AI agent via the Telegram Bot API. 14 tools, bot-token auth. Outbound + lightweight read of recent updates (no long-polling).

Try asking

Example prompts for Telegram Bot

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Telegram Bot · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Telegram Bot, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Telegram Bot + Claude

Send Telegram messages, photos, documents, audio, location and polls from any AI agent via the Telegram Bot API. 14 tools, bot-token auth. Outbound + lightweight read of recent updates (no long-polling).

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

TELEGRAM_BOT_TOKEN

Step 1 — Get credentials

telegram.org/bots/api).

Setup:

  1. In Telegram, open chat with @BotFather/newbot → pick a display name and a username ending in bot.
  2. BotFather replies with an HTTP API token like 123456789:ABCDEFghijklmnopqrstuvwxyz. Treat as a secret — anyone with it can send as your bot.
  3. Set TELEGRAM_BOT_TOKEN to the full token.

Authentication model (Telegram-specific): the bot token goes in the URL path, NOT in a header. The base URL is https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN} and every endpoint is appended as /methodName. The adapter substitutes the token via the {{TELEGRAM_BOT_TOKEN}} env-var template in baseUrl.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 3 — Add the connector in Claude

Recommended path — works on claude.ai web without editing any config file.

  1. Open claude.ai/customize/connectors.
  2. Click "Add custom connector".
  3. Fill in:
    • Name: Telegram Bot
    • URL: https://cloud.anythingmcp.com/mcp
    • Authentication: Bearer token → paste your MCP API key (from AnythingMCP → Profile → MCP API Keys → New Key)
  4. Click Connect to authorize.

All tools below appear in your chat — start typing prompts.

Available tools

ToolWhat it does
telegram_bot_get_meReturn the bot's own user info: id, username, first_name, can_join_groups, can_read_all_group_messages, supports_inline_queries
telegram_bot_send_messageSend a text message to a chat
telegram_bot_send_photoSend a photo (JPG/PNG, ≤5MB via URL) by HTTPS URL or by reusable file_id
telegram_bot_send_documentSend a document (any type, ≤20MB via URL) by HTTPS URL or file_id
telegram_bot_send_audioSend an audio file (MP3, M4A, ≤20MB via URL)
telegram_bot_send_voiceSend a voice note (OGG-Opus encoded)
telegram_bot_send_videoSend a video (MP4, H
telegram_bot_send_locationSend a location point
telegram_bot_send_pollSend a poll (regular or quiz)
telegram_bot_edit_message_textEdit the text of a previously-sent message (your bot's own messages only)
telegram_bot_delete_messageDelete a message the bot sent (within ~48 hours for groups, anytime for own DMs)
telegram_bot_get_chatFetch chat info: title, type (private/group/supergroup/channel), photo, description, invite_link, member_count, permissions
telegram_bot_get_updatesLong-poll recent inbound messages (one-shot — pulls all updates since the last offset+1)

FAQ

Does it work with Claude Code as well as Claude Desktop? Yes — point both at https://cloud.anythingmcp.com/mcp.

Next steps

Was this guide helpful?

Ready to ship

Your Telegram agent is one click away.

Install the connector, paste the key, prompt Claude. Free for 7 days, no credit card.

Related guides