Telegram MCP server

Connect Telegram to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Telegram MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the answer callback query tool in Telegram
  • Use the pin/unpin message tool in Telegram
  • Use the manage chat member tool in Telegram
  • Use the send poll tool in Telegram
  • Use the answer inline query tool in Telegram
  • Use the send message tool in Telegram

Supported Tools

answer_callback_query

Answer Callback Query

Respond to a callback query from an inline keyboard button press. Can show a notification or alert to the user, or open a URL. Must be called within 30 seconds of receiving the callback.

pin_message

Pin/Unpin Message

Pin or unpin a message in a chat. Can pin a specific message, unpin a specific message, or unpin all messages. The bot must be an admin with the appropriate pin permission.

manage_chat_member

Manage Chat Member

Manage a chat member by banning, unbanning, restricting, or promoting them. Can also retrieve a member's current status and permissions. The bot must be an admin with appropriate rights.

send_poll

Send Poll

Create and send a poll or quiz to a chat. Supports regular polls with optional multiple-answer mode, and quiz-mode polls with one or more correct answers and an explanation.

answer_inline_query

Answer Inline Query

Respond to an inline query with a list of results. When a user types "@botname query" in any chat, the bot receives an inline query and should respond with results the user can select and send.

send_message

Send Message

Send a text message to a Telegram chat, group, supergroup, or channel. Supports HTML and Markdown formatting, inline keyboards with callback buttons or URLs, and replying to specific messages.

forward_message

Forward Message

Forward a message from one chat to another. The original sender attribution is preserved.

get_chat

Get Chat

Retrieve detailed information about a chat including its type, title, description, member count, and permissions. Works for private chats, groups, supergroups, and channels.

send_media

Send Media

Send a photo, document, audio, or video message to a chat. Provide a URL or file ID for the media. Supports captions with formatting.

update_chat

Update Chat

Update a chat's title, description, or create an invite link. The bot must be an admin with the appropriate permissions.

edit_message

Edit Message

Edit the text of a previously sent message, or the caption of a photo, video, audio, or document message. Works for messages sent by the bot in any chat, or inline messages. Provide either chatId + messageId, or inlineMessageId.

get_file

Get File

Retrieve file information for a file shared in Telegram and provide it as a downloadable file. Use the file_id from a received message.

send_invoice

Send Invoice

Send a payment invoice to a user or chat. Supports Telegram Stars and third-party payment providers. Can also generate a shareable invoice link instead of sending directly.

delete_message

Delete Message

Delete a message from a chat. The bot can delete its own messages in any chat, and can delete other users' messages in groups/supergroups if it has the appropriate admin permissions.

stop_poll

Stop Poll

Stop a live poll in a chat, freezing its current results. Once stopped, no more votes can be cast.

get_bot_info

Get Bot Info

Get the connected Telegram bot's identity and settings: its user ID, name, username, and whether it can join groups, read all group messages, and answer inline queries.

get_updates

Get Updates

Fetch recent incoming updates for the bot, such as messages, button presses, inline queries, and membership changes. Use it to find chat IDs, read messages sent to the bot, and get callback or inline query IDs to answer.

Connect Telegram to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Telegram in Metorial. In your Metorial portal, enable the Telegram MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Telegram tools.

Run Telegram through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Telegram and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Telegram tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Telegram

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Gmail

Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Manage filters and vacation responders, update the primary address's display name and signature, and view send-as aliases, forwarding addresses, and auto-forwarding status. Import and insert messages for migration.

Google Drive

Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Technical notes for Telegram

Send, edit, delete, forward, and pin messages in private chats, groups, supergroups, and channels. Support text, photo, video, audio, document, and sticker messages with rich formatting (HTML, Markdown) and interactive keyboards. Handle inline queries to provide rich search results directly in any chat. Manage chat members (kick, ban, unban), edit chat settings and permissions, create and manage invite links, and handle join requests. Process payments and invoices using Telegram Stars or third-party payment providers. Create, edit, and delete sticker and custom emoji packs. Serve HTML5 games with score tracking. Launch interactive Mini Apps (Web Apps) within chats. Integrate with business accounts to manage and reply to messages on behalf of businesses. Create and manage polls and quizzes. Upload and download files.

Frequently asked questions

Common questions about connecting Telegram to AI agents with Metorial.

  1. How many tools does the Telegram MCP server have?
    The Telegram MCP server exposes 17 tools, including Answer Callback Query, Pin/Unpin Message, Manage Chat Member. Each one is governed and traced through Metorial.
  2. Telegram exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Telegram MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Telegram and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Telegram MCP server yourself or use the hosted gateway.

Connect Telegram to production AI agents

See how Metorial gives your team governed access to Telegram, with tracing and security controls built in.