Connector guide7-minute read33 MCP tools7 languages

Telegram MCP Server: Messages, Media and Polls

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API. 33 tools, bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

HCBy HelpCode teamUpdated 7 min read Open-source on GitHub

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

Telegram Bot

Telegram Bot

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API, react to and pin messages, and manage group titles, invite links and forum topics. Bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

tools

33

Region

INTL

Category

Messaging

Authentication

API credentials

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

Summary

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API. 33 tools, bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

Guided setup

Connect Telegram Bot to Claude, ChatGPT or Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Telegram Bot in the guided setup, then add your MCP URL to your AI assistant. No code and no server to run.

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

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 and you're done. No Docker, no git clone, no local server.

Telegram Bot

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API. 33 tools, bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

Setup

  1. In Telegram, open a chat with @BotFather, send /newbot and pick a display name and a username ending in bot.
  2. BotFather replies with a token like 123456789:ABCdef.... Treat it as a secret: anyone who has it can send as your bot.
  3. Paste the full token into TELEGRAM_BOT_TOKEN and install the connector. Telegram expects the token in the request address, and the connector puts it there for you.
  4. Start with telegram_bot_get_me to check that the token works.

Who the bot can reach: every chat has a numeric chat_id. A user must have sent /start to your bot at least once, and groups and channels need the bot added first. Public channels also accept @channelusername; private channels need the numeric id, which starts with -100. telegram_bot_get_updates shows recent incoming messages with their chat ids.

What it sends: text messages (HTML formatting is the safest choice), photos, albums, documents, audio files, voice notes, videos, GIF animations, stickers, contact cards, venues, locations (also live locations) and polls or quizzes. It can also edit and delete its own messages and read chat details.

Albums: telegram_bot_send_album sends 2 to 10 photos and videos as one grouped message, or 2 to 10 documents, or 2 to 10 audio files; documents and audio cannot be mixed with other types. The caption goes on the first item. If Telegram reports WEBPAGE_CURL_FAILED for one item, it could not download that file: the link must be public and point straight at the file, not at a web page.

Files: media are sent by HTTPS link (up to 5 MB for photos and 20 MB for other files) or by the file_id of something sent before. Uploading a file from your computer in the same call is not supported.

Reactions, pins and chat management: the bot can react to a message with an emoji and change the caption of a photo, video or document it sent. In groups and channels where it is an administrator with the matching right (pin messages, change chat info, invite users, manage topics), it pins and unpins messages, renames the chat, changes its description, creates extra invite links (named, expiring or limited to a number of joins) and opens topics in forum groups. It can also turn existing images into a new sticker set owned by a user and add stickers to it. telegram_bot_get_webhook_info shows whether the bot has a webhook; while one is set, telegram_bot_get_updates answers 409 Conflict. telegram_bot_remove_webhook deletes the webhook and is switched off at install, because the service that receives it (a chatbot, an automation) then stops getting messages: switch it on deliberately on the connector page; the AI asks before every change.

Already installed? The new tools reach a connector you installed earlier through its catalog update: open the connector in AnythingMCP and, under Catalog update available, check the list of new tools and click Apply update. Your bot token and any tools you added yourself stay as they are, and telegram_bot_remove_webhook arrives switched off, as on a new install.

Rate limits: about 30 messages a second across different chats, 1 a second to the same chat and 20 a minute to the same group. On a 429, Telegram says how long to wait.

The connector reads recent updates when asked and does not run a chatbot that answers on its own, which needs a webhook you host. Payments, inline mode and games are not covered.

Prerequisites: TELEGRAM_BOT_TOKEN

Install the connector locally

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Open http://localhost:3000/connectors/store, pick Telegram Bot and paste in the env vars listed under Prerequisites.

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.264, AAC, ≤20MB via URL)
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)
telegram_bot_send_albumSend 2 to 10 photos or videos as one album (sendMediaGroup), or 2 to 10 documents, or 2 to 10 audio files; documents and audio cannot be…
telegram_bot_send_animationSend a GIF or a silent MP4 animation by HTTPS URL or file_id; Telegram plays it on a loop
telegram_bot_send_stickerSend a sticker by file_id (any sticker the bot has seen, e.g. from telegram_bot_get_updates) or by HTTPS URL of a .WEBP image
telegram_bot_send_contactSend a phone contact card that the recipient can save or call
telegram_bot_send_venueSend a venue: a map pin with a name and address, e.g. a shop or meeting point
telegram_bot_get_fileLook up a file the bot received (photo, document, voice note, video) by its file_id, from a message in telegram_bot_get_updates
telegram_bot_download_fileDownload a file by the file_path telegram_bot_get_file returned
telegram_bot_fetch_sticker_setRead a sticker set (or custom emoji set) by its name: title, sticker_type (regular, mask, custom_emoji) and every sticker with its emoji…
telegram_bot_react_to_messageSet the bot's reaction on a message (the emoji under a message), or remove it with an empty list
telegram_bot_pin_messagePin a message in a chat, so it shows at the top
telegram_bot_unpin_chat_messageUnpin a pinned message in a chat; without message_id the most recently pinned message is unpinned
telegram_bot_rename_chatChange the title of a group, supergroup or channel (1 to 128 characters); not possible for private chats
telegram_bot_update_chat_descriptionChange the description of a group, supergroup or channel (0 to 255 characters; empty removes it)
telegram_bot_add_forum_topicCreate a topic in a forum supergroup (a group with topics enabled)
telegram_bot_edit_message_captionEdit the caption of a photo, video, document, audio or animation message the bot sent (an empty caption removes it)
telegram_bot_create_chat_invite_linkCreate an additional invite link for a group, supergroup or channel, optionally named, expiring, limited to a number of joins, or requiring…
telegram_bot_create_sticker_setCreate a new sticker set owned by a user, with 1 to 50 first stickers from existing image files
telegram_bot_extend_sticker_setAdd one sticker to a sticker set the bot created (telegram_bot_create_sticker_set)
telegram_bot_get_webhook_infoShow whether the bot has a webhook: its url (empty when none), pending_update_count, the last error date and message, and allowed_updates
telegram_bot_remove_webhookRemove the bot's webhook so updates can be read with telegram_bot_get_updates again

Example prompts

  • "Send the photos from these four links as one album to our team channel, with the caption 'New collection, live today'."
  • "Post a poll in the sales group: which day works for the quarterly review, Tuesday or Thursday?"
  • "Send our shop's address as a venue to the customer chat so they can open it in their maps app."
  • "Show me the messages the bot received in the last hour and who sent them."
  • "Pin the message about the holiday opening hours in the customer group and react to it with a thumbs up."
  • "Create an invite link for the beta group that expires on Friday and allows at most 50 joins."

Next steps

Was this guide helpful?

Connect Telegram Bot to Claude, ChatGPT or Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Telegram Bot in the guided setup, then add your MCP URL to your AI assistant. No code and no server to run.

Related guides

Connectors

Connect Telegram to Microsoft Copilot via MCP

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API. 33 tools, bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

Connectors

Connect Telegram to Meta Muse via MCP

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API. 33 tools, bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

Connectors

Connect Telegram to ChatGPT via MCP: Messages and Media

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API. 33 tools, bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

Connectors

Connect Telegram to Claude via MCP: Messages and Polls

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API. 33 tools, bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

Connectors

Connect Telegram to Cursor via MCP: Messages and Polls

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API. 33 tools, bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

Connectors

Connect Telegram to Gemini CLI via MCP

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API. 33 tools, bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).