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 ChatGPT in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Telegram Bot in the guided setup, then add your MCP URL to ChatGPT. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
AnythingMCP's plugin in ChatGPT's directory answers questions from your company databases on AnythingMCP Cloud (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, read-only): open the listing (opens in a new tab) and click Install plugin. Every other connector is added to ChatGPT as a custom MCP server with your AnythingMCP MCP URL.
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.
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 + ChatGPT
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).
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
- In Telegram, open a chat with @BotFather, send
/newbotand pick a display name and a username ending inbot. - BotFather replies with a token like
123456789:ABCdef.... Treat it as a secret: anyone who has it can send as your bot. - Paste the full token into
TELEGRAM_BOT_TOKENand install the connector. Telegram expects the token in the request address, and the connector puts it there for you. - Start with
telegram_bot_get_meto 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.
Step 2 — Install the adapter
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
Step 3 — Add the connector in ChatGPT
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.
- Go to chatgpt.com/plugins, click Add, then Add custom MCP server.
- Enter a name, e.g. Name:
Telegram Bot. - Under Connection, enter the Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDand keep Authentication on OAuth. - Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
- Install the new plugin from your personal plugins, then type @ in a chat and pick it.
Available tools
| Tool | What it does |
|---|---|
telegram_bot_get_me | Return the bot's own user info: id, username, first_name, can_join_groups, can_read_all_group_messages, supports_inline_queries |
telegram_bot_send_message | Send a text message to a chat |
telegram_bot_send_photo | Send a photo (JPG/PNG, ≤5MB via URL) by HTTPS URL or by reusable file_id |
telegram_bot_send_document | Send a document (any type, ≤20MB via URL) by HTTPS URL or file_id |
telegram_bot_send_audio | Send an audio file (MP3, M4A, ≤20MB via URL) |
telegram_bot_send_voice | Send a voice note (OGG-Opus encoded) |
telegram_bot_send_video | Send a video (MP4, H.264, AAC, ≤20MB via URL) |
telegram_bot_send_location | Send a location point |
telegram_bot_send_poll | Send a poll (regular or quiz) |
telegram_bot_edit_message_text | Edit the text of a previously-sent message (your bot's own messages only) |
telegram_bot_delete_message | Delete a message the bot sent (within ~48 hours for groups, anytime for own DMs) |
telegram_bot_get_chat | Fetch chat info: title, type (private/group/supergroup/channel), photo, description, invite_link, member_count, permissions |
telegram_bot_get_updates | Long-poll recent inbound messages (one-shot: pulls all updates since the last offset+1) |
telegram_bot_send_album | Send 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_animation | Send a GIF or a silent MP4 animation by HTTPS URL or file_id; Telegram plays it on a loop |
telegram_bot_send_sticker | Send 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_contact | Send a phone contact card that the recipient can save or call |
telegram_bot_send_venue | Send a venue: a map pin with a name and address, e.g. a shop or meeting point |
telegram_bot_get_file | Look 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_file | Download a file by the file_path telegram_bot_get_file returned |
telegram_bot_fetch_sticker_set | Read 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_message | Set the bot's reaction on a message (the emoji under a message), or remove it with an empty list |
telegram_bot_pin_message | Pin a message in a chat, so it shows at the top |
telegram_bot_unpin_chat_message | Unpin a pinned message in a chat; without message_id the most recently pinned message is unpinned |
telegram_bot_rename_chat | Change the title of a group, supergroup or channel (1 to 128 characters); not possible for private chats |
telegram_bot_update_chat_description | Change the description of a group, supergroup or channel (0 to 255 characters; empty removes it) |
telegram_bot_add_forum_topic | Create a topic in a forum supergroup (a group with topics enabled) |
telegram_bot_edit_message_caption | Edit the caption of a photo, video, document, audio or animation message the bot sent (an empty caption removes it) |
telegram_bot_create_chat_invite_link | Create 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_set | Create a new sticker set owned by a user, with 1 to 50 first stickers from existing image files |
telegram_bot_extend_sticker_set | Add one sticker to a sticker set the bot created (telegram_bot_create_sticker_set) |
telegram_bot_get_webhook_info | Show 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_webhook | Remove 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."
FAQ
Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.
Next steps
- Connector landing page
- Connect to Claude
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
- Connect to Microsoft Copilot
Was this guide helpful?