Telegram
Messaging and bots.
Verdict
Common use cases
- Send automated alerts to Telegram channels
- Archive support conversations to Notion
- Moderate group chats by deleting spam
- Generate invite links for new members
- Forward customer questions to internal chat
Integration
- Vendor
- Telegram
- Category
- communication
- Auth
- API_KEY
- Tools
- 17
- Composio slug
telegram
Tools
- Answer Callback Query
Use this method to send answers to callback queries sent from inline keyboards. the answer will be displayed to the user as a notification at the top of the chat screen or as an alert.
- Delete Messagedestructive
Delete a message, including service messages, with certain limitations.
- Edit Message
Edit text messages sent by the bot.
- Export Chat Invite Link
Generate a new primary invite link for a chat; any previously generated primary link is revoked. the bot must be an administrator in the chat for this to work and must have the appropriate administrator rights.
- Forward Message
Forward messages of any kind. service messages can't be forwarded.
- Get Bot Info
Get basic information about the bot using the bot api getme method.
- Get Chat Administrators
Get a list of administrators in a chat. on success, returns an array of chatmember objects that contains information about all chat administrators except other bots.
- Get Chat History
Get chat history messages. note: this uses the getupdates method with specific parameters to retrieve historical messages.
- Get Chat Info
Get up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.).
- Get Chat Members Count
Get the number of members in a chat. the bot must be an administrator in the chat for this to work.
- Get Updates
Use this method to receive incoming updates using long polling. an array of update objects is returned.
- Send Document
Send general files (documents) to a telegram chat using the bot api.
- Send Location
Send point on the map location to a telegram chat using the bot api.
- Send Message
Send a text message to a telegram chat using the bot api.
- Send Photo
Send photos to a telegram chat using the bot api.
- Send Poll
Send a native poll to a telegram chat using the bot api.
- Set Bot Commands
Use this method to change the list of the bot's commands. see https://core.telegram.org/bots#commands for more details about bot commands.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings → Integrations → Add MCP. 2. Select Telegram from the list and click Connect. 3. You'll be prompted to paste a Telegram Bot API token — get this by messaging @BotFather on Telegram, creating a new bot, and copying the token it provides. 4. Paste the token into Switchy and click Authorize. 5. Add your bot to any Telegram groups or channels you want to control, then promote it to admin with permissions to post messages, delete messages, and manage invite links. 6. Return to Switchy and open a Space. 7. Type '@Telegram get bot info' to confirm the connection works — you should see your bot's username and ID. 8. Now you can invoke any tool by @mentioning Telegram followed by your instruction.
What teammates see: by default, memories from Telegram are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Send Status Update
@Telegram send a message to our #engineering channel saying 'Deploy to staging complete — build 2.4.1 is live for testing.'Open in a Space →
Archive Support Thread
@Telegram get chat history from the last 50 messages in chat ID -1001234567890, then summarize the customer's issue and our resolution.Open in a Space →
Moderate Spam
@Telegram delete message ID 12345 from chat -1001234567890, then answer the callback query with 'Message removed for violating community guidelines.'Open in a Space →
Generate Invite Link
@Telegram export a new invite link for chat ID -1001234567890 and paste it here so I can send it to the new contractor.Open in a Space →
Forward Customer Question
@Telegram forward message ID 67890 from chat -1001111111111 to our internal support chat -1002222222222.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@telegram show me the last 20 messages from our #product-updates channel so I can draft a weekly summary
Retrieved 20 recent messages from #product-updates. The channel shows 8 feature announcements, 5 bug-fix notifications, 4 deployment confirmations, and 3 user feedback threads. Most active discussion centered around the new dashboard redesign (12 replies) and API rate-limit adjustments (7 replies). Messages span March 15-22, with peak activity on March 18.
This example uses Get Chat History to fetch messages. Requires the bot to be added to the target channel with read permissions. Telegram's getUpdates method has a 100-message rolling window, so 'last 20' works reliably but deeper history may require adjusting your bot's offset parameter or using a different retrieval strategy.
@telegram forward the message about Q1 roadmap priorities from Sarah to our #leadership-sync channel
Forwarded Sarah's message (sent March 20, 2:34 PM) to #leadership-sync. The message contained a bulleted list of 5 Q1 priorities with owner assignments and target dates. Forward preserved the original timestamp and sender attribution. Message ID in destination channel: 8472.
This demonstrates Forward Message for cross-channel coordination. The bot must have posting permissions in the destination channel. Forwarded messages retain original sender context, which helps preserve attribution but means you can't anonymize or rewrite content during the forward—use Edit Message afterward if you need to add context.
@telegram who are the admins in our #engineering channel and what permissions does each one have?
Found 4 administrators in #engineering: Alex Chen (creator, all permissions), Jordan Kim (can delete messages, pin messages, invite users), Sam Patel (can manage video chats, invite users), and @ProductBot (can post messages, edit messages). Two members have restricted 'can invite users' only. The channel has 47 total members.
Uses Get Chat Administrators to audit channel governance. Useful for onboarding or security reviews. Returns ChatMember objects with granular permission flags, but the MCP won't show you *why* someone has those permissions (manual grant vs. role inheritance). If your bot isn't an admin itself, this call will fail with a 'not enough rights' error.
Use-case deep-dives
When Telegram MCP beats email for support handoffs
A 6-person support team uses Telegram as their primary customer channel and needs AI to draft replies, escalate to the right person, and log resolutions. This MCP is the right call if your team already lives in Telegram and handles under 200 tickets a day. The Edit Message and Answer Callback Query tools let Switchy refine responses inline and handle button clicks without switching contexts. The Get Chat History tool pulls recent context so the AI doesn't ask customers to repeat themselves. The threshold: if you need structured ticket IDs or SLA tracking, Telegram's flat chat model gets messy fast—Linear or Zendesk MCPs win there. But for conversational support where speed matters more than audit trails, this MCP keeps your team in one place and cuts reply time in half.
Telegram MCP for group chat moderation workflows
A 2-person community team moderates a 50-member Telegram group for a SaaS product's power users. They need AI to flag spam, answer repeat questions, and surface admin requests without reading every message. This MCP works if your group is under 100 members and you trust the bot with admin rights. The Get Chat Administrators and Delete Message tools let Switchy enforce rules and remove bad actors. The Forward Message tool escalates edge cases to a private admin chat. The trade-off: Telegram's API doesn't expose message sentiment or thread structure, so the AI can't distinguish heated debate from actual toxicity without reading full history. If your community is over 200 members or spans multiple groups, Discord's richer metadata wins. For tight-knit groups where you know the regulars, this MCP automates the grunt work and keeps moderators focused on real problems.
When Telegram MCP fits inbound lead capture
A 3-person sales team at a B2B startup uses a Telegram bot to capture inbound leads from a landing page. Prospects message the bot with questions, and the team needs AI to qualify intent, book demos, and route hot leads to Slack. This MCP is the right call if you get under 50 leads a week and your buyers prefer chat over forms. The Get Bot Info and Edit Message tools let Switchy personalize responses and correct mistakes mid-conversation. The Export Chat Invite Link tool generates one-time links for demo groups. The boundary: Telegram doesn't integrate with CRMs natively, so you'll need Zapier or a custom webhook to log leads in HubSpot. If your lead volume is over 100 a week or you need multi-step nurture sequences, a dedicated chatbot platform like Intercom wins. For lean teams testing a conversational funnel, this MCP gets you live in an afternoon and costs nothing but API setup.
Frequently asked
What can the Telegram MCP do in Switchy?
The Telegram MCP lets your AI agents send, edit, and delete messages in Telegram chats, forward messages between conversations, manage chat invites, and retrieve chat history. It's built for bots that need to interact with Telegram groups or channels — not for reading your personal DMs. You connect it once with a bot token, then any agent in your workspace can call its 17 tools.
Do I need admin access to use the Telegram MCP?
You need a Telegram bot token from BotFather — no admin access required for basic messaging. However, tools like exporting invite links or listing chat administrators only work if your bot has been promoted to admin in the target chat. The MCP uses API_KEY auth, so you paste the token once in Switchy and it applies to all agents.
Can the Telegram MCP read messages sent by other users?
Yes, via the Get Chat History tool, which polls Telegram's getUpdates endpoint. This retrieves recent messages the bot has access to — typically messages in groups where the bot is a member. It won't see messages in private chats unless a user explicitly starts a conversation with your bot. Service messages like pinned-message notifications can't be forwarded or retrieved.
How does this compare to using Telegram's Bot API directly?
The MCP wraps Telegram's Bot API in a format Claude and other LLMs understand natively. Instead of writing code to parse webhooks or poll getUpdates, your agent just calls 'Forward Message' or 'Edit Message' as a tool. You lose nothing in capability — it's the same API underneath — but gain the ability to compose Telegram actions with other MCPs in a single prompt.
Who on my team should connect the Telegram MCP?
Whoever owns your Telegram bot token. That person creates the bot in BotFather, copies the token, and pastes it into Switchy's MCP settings. After that, any team member with access to your Switchy workspace can build agents that use the Telegram tools. The bot's permissions in each chat still apply — Switchy doesn't bypass Telegram's admin rules.