Claude MarketplacesSubmit
daedalus avatar

Mcp Telegram Bot

daedalus/mcp-telegram-bot

Connects Claude to the Telegram Bot API so you can send messages, check bot status, and poll for updates without writing integration code yourself. You get three tools: send_message for pushing text to chats, get_me for bot info, and get_updates for fetching recent activity. Requires a bot token from BotFather and runs over stdio transport. Reach for this when you want Claude to interact with Telegram channels or groups directly, like monitoring conversations, posting notifications, or building automated responses. The resource endpoint exposes bot status for quick health checks.

tools
27
transport
STDIO
last updated
Mar 28, 2026
View on GitHub

Tools

27 tools

Public tool metadata for what this MCP can expose to an agent.

tg_get_meGet basic information about the bot: id, username, first_name, can_join_groups, can_read_all_group_messages, supports_inline_queries.1 params

Get basic information about the bot: id, username, first_name, can_join_groups, can_read_all_group_messages, supports_inline_queries.

Parameters* required
_fieldsstring
Comma-separated list of fields to include in the response (e.g. "id,username,first_name")
tg_set_my_commandsSet the list of bot commands shown in the Telegram chat menu. Each command has a "command" (1-32 chars, lowercase a-z, 0-9, _) and a "description" (1-256 chars). Max 100 commands.3 params

Set the list of bot commands shown in the Telegram chat menu. Each command has a "command" (1-32 chars, lowercase a-z, 0-9, _) and a "description" (1-256 chars). Max 100 commands.

Parameters* required
commandsarray
Array of BotCommand objects
language_codestring
Two-letter ISO 639-1 language code
scopeobject
Optional scope e.g. {"type":"all_private_chats"}
tg_send_messageSend a text message to a chat. Supports Markdown, MarkdownV2, and HTML formatting. Can include inline keyboards via reply_markup.7 params

Send a text message to a chat. Supports Markdown, MarkdownV2, and HTML formatting. Can include inline keyboards via reply_markup.

Parameters* required
chat_idstring
Chat ID (number) or @channel_username
disable_notificationboolean
Send silently (no notification sound)
parse_modestring
"Markdown", "MarkdownV2", or "HTML"
protect_contentboolean
Prevent message from being forwarded/saved
reply_markupobject
InlineKeyboardMarkup, ReplyKeyboardMarkup, etc.
reply_to_message_idnumber
Message ID to reply to
textstring
Message text (1-4096 characters)
tg_send_photoSend a photo to a chat. Provide a URL or file_id from a previously uploaded photo.6 params

Send a photo to a chat. Provide a URL or file_id from a previously uploaded photo.

Parameters* required
captionstring
Photo caption (0-1024 characters)
chat_idstring
Chat ID or @channel_username
parse_modestring
Caption parse mode
photostring
Photo URL or file_id
reply_markupobject
Optional reply markup
reply_to_message_idnumber
Message ID to reply to
tg_send_documentSend a document/file to a chat. Provide a URL or file_id. Max 50MB for bots.5 params

Send a document/file to a chat. Provide a URL or file_id. Max 50MB for bots.

Parameters* required
captionstring
Document caption (0-1024 characters)
chat_idstring
Chat ID or @channel_username
documentstring
Document URL or file_id
parse_modestring
Caption parse mode
reply_markupobject
Optional reply markup
tg_send_videoSend a video to a chat. Provide a URL or file_id. Supports MPEG4 format, max 50MB.7 params

Send a video to a chat. Provide a URL or file_id. Supports MPEG4 format, max 50MB.

Parameters* required
captionstring
Video caption
chat_idstring
Chat ID or @channel_username
durationnumber
Duration in seconds
heightnumber
Video height
parse_modestring
Caption parse mode
videostring
Video URL or file_id
widthnumber
Video width
tg_send_audioSend an audio file to a chat. Displayed as a music player. Provide a URL or file_id. Max 50MB, MP3/M4A format.7 params

Send an audio file to a chat. Displayed as a music player. Provide a URL or file_id. Max 50MB, MP3/M4A format.

Parameters* required
audiostring
Audio URL or file_id
captionstring
Audio caption
chat_idstring
Chat ID or @channel_username
durationnumber
Duration in seconds
parse_modestring
Caption parse mode
performerstring
Performer name
titlestring
Track name
tg_send_locationSend a geographic location point to a chat.4 params

Send a geographic location point to a chat.

Parameters* required
chat_idstring
Chat ID or @channel_username
latitudenumber
Latitude (-90 to 90)
longitudenumber
Longitude (-180 to 180)
reply_markupobject
Optional reply markup
tg_send_pollSend a poll to a chat. Supports regular polls and quiz mode. For quiz mode, set type to "quiz" and provide correct_option_id.7 params

Send a poll to a chat. Supports regular polls and quiz mode. For quiz mode, set type to "quiz" and provide correct_option_id.

Parameters* required
allows_multiple_answersboolean
Allow multiple answers (regular polls only)
chat_idstring
Chat ID or @channel_username
correct_option_idnumber
Required for quiz: 0-based index of correct answer
is_anonymousboolean
Anonymous poll (default: true)
optionsarray
Answer options (2-10 strings, each 1-100 chars)
questionstring
Poll question (1-300 characters)
typestring
"regular" or "quiz"
tg_send_contactSend a phone contact card to a chat.4 params

Send a phone contact card to a chat.

Parameters* required
chat_idstring
Chat ID or @channel_username
first_namestring
Contact first name
last_namestring
Contact last name
phone_numberstring
Contact phone number
tg_edit_message_textEdit the text of a previously sent message. The bot must be the author of the message.5 params

Edit the text of a previously sent message. The bot must be the author of the message.

Parameters* required
chat_idstring
Chat ID
message_idnumber
Message ID to edit
parse_modestring
Parse mode for new text
reply_markupobject
New inline keyboard markup
textstring
New text (1-4096 characters)
tg_edit_message_captionEdit the caption of a previously sent media message (photo, video, document, audio).5 params

Edit the caption of a previously sent media message (photo, video, document, audio).

Parameters* required
captionstring
New caption (0-1024 characters)
chat_idstring
Chat ID
message_idnumber
Message ID to edit
parse_modestring
Parse mode for caption
reply_markupobject
New inline keyboard markup
tg_delete_messageDelete a message. Bot must have delete permission in group chats. Messages older than 48 hours cannot be deleted.2 params

Delete a message. Bot must have delete permission in group chats. Messages older than 48 hours cannot be deleted.

Parameters* required
chat_idstring
Chat ID
message_idnumber
Message ID to delete
tg_get_chatGet detailed information about a chat: title, description, type, member count, permissions, pinned message, etc.1 params

Get detailed information about a chat: title, description, type, member count, permissions, pinned message, etc.

Parameters* required
chat_idstring
Chat ID or @channel_username
tg_get_chat_member_countGet the number of members in a chat.1 params

Get the number of members in a chat.

Parameters* required
chat_idstring
Chat ID or @channel_username
tg_get_chat_memberGet information about a specific member: status (creator, administrator, member, restricted, left, kicked), permissions, and custom title.2 params

Get information about a specific member: status (creator, administrator, member, restricted, left, kicked), permissions, and custom title.

Parameters* required
chat_idstring
Chat ID or @channel_username
user_idnumber
Telegram user ID
tg_ban_chat_memberBan a user from a group, supergroup, or channel. The user will be unable to return unless unbanned. Bot must be admin with ban permission.4 params

Ban a user from a group, supergroup, or channel. The user will be unable to return unless unbanned. Bot must be admin with ban permission.

Parameters* required
chat_idstring
Chat ID
revoke_messagesboolean
Delete all messages from this user in the chat
until_datenumber
Unix timestamp for ban expiry (0 or omit for permanent)
user_idnumber
User ID to ban
tg_unban_chat_memberUnban a previously banned user. The user is NOT added back automatically and must rejoin via invite link.3 params

Unban a previously banned user. The user is NOT added back automatically and must rejoin via invite link.

Parameters* required
chat_idstring
Chat ID
only_if_bannedboolean
Only unban if currently banned (default: false)
user_idnumber
User ID to unban
tg_set_webhookSet a webhook URL for receiving Telegram updates. Telegram sends POST requests with JSON Update objects to this URL. Supported ports: 443, 80, 88, 8443.4 params

Set a webhook URL for receiving Telegram updates. Telegram sends POST requests with JSON Update objects to this URL. Supported ports: 443, 80, 88, 8443.

Parameters* required
allowed_updatesarray
Update types to receive, e.g. ["message","callback_query"]
max_connectionsnumber
Max simultaneous connections (1-100, default 40)
secret_tokenstring
Secret token for X-Telegram-Bot-Api-Secret-Token header (1-256 chars)
urlstring
HTTPS URL for receiving updates
tg_delete_webhookRemove the webhook integration. After this, you can use getUpdates for polling.1 params

Remove the webhook integration. After this, you can use getUpdates for polling.

Parameters* required
drop_pending_updatesboolean
Drop all pending updates
tg_get_webhook_infoGet current webhook status: URL, pending update count, last error date/message, max connections, and allowed update types.1 params

Get current webhook status: URL, pending update count, last error date/message, max connections, and allowed update types.

Parameters* required
_fieldsstring
Comma-separated list of fields to include in the response (e.g. "url,pending_update_count")
tg_answer_callback_queryAnswer a callback query from an inline keyboard button press. Must be called to stop the loading indicator on the button.3 params

Answer a callback query from an inline keyboard button press. Must be called to stop the loading indicator on the button.

Parameters* required
callback_query_idstring
Callback query ID from the update
show_alertboolean
Show as alert popup instead of notification at top
textstring
Notification text (0-200 chars)
tg_get_fileGet file info and download URL. Returns file_id, file_size, file_path, and a ready-to-use download_url. Files up to 20MB.1 params

Get file info and download URL. Returns file_id, file_size, file_path, and a ready-to-use download_url. Files up to 20MB.

Parameters* required
file_idstring
File identifier from a message
tg_get_user_profile_photosGet a list of profile photos for a user.3 params

Get a list of profile photos for a user.

Parameters* required
limitnumber
Max photos to return (1-100, default 100)
offsetnumber
Photo offset for pagination
user_idnumber
Telegram user ID
tg_pin_chat_messagePin a message in a chat. Bot must have pin_messages admin permission in groups/supergroups.3 params

Pin a message in a chat. Bot must have pin_messages admin permission in groups/supergroups.

Parameters* required
chat_idstring
Chat ID
disable_notificationboolean
Pin silently (no notification)
message_idnumber
Message ID to pin
tg_unpin_chat_messageUnpin a message in a chat. If message_id is not provided, unpins the most recent pinned message.2 params

Unpin a message in a chat. If message_id is not provided, unpins the most recent pinned message.

Parameters* required
chat_idstring
Chat ID
message_idnumber
Message ID to unpin (omit to unpin latest)
tg_create_chat_invite_linkCreate an additional invite link for a chat. Bot must be admin with invite_users permission.4 params

Create an additional invite link for a chat. Bot must be admin with invite_users permission.

Parameters* required
chat_idstring
Chat ID
expire_datenumber
Unix timestamp when the link expires
member_limitnumber
Max users that can join via this link (1-99999)
namestring
Invite link name (0-32 chars)

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

mcp-telegram-bot

MCP server that exposes a Telegram bot

PyPI Python Coverage Ruff

Install

pip install mcp-telegram-bot

Setup

  1. Create a Telegram bot by talking to @BotFather on Telegram
  2. Get your bot token
  3. Set the TELEGRAM_BOT_TOKEN environment variable

Usage

export TELELEGRAM_BOT_TOKEN="your-bot-token-here"
mcp-telegram-bot

MCP Tools

  • send_message: Send a message to a Telegram chat
  • get_me: Get bot information
  • get_updates: Get recent updates from Telegram

MCP Resources

  • bot://status: Get bot status

mcp-name: io.github.daedalus/mcp-telegram-bot

Development

View the full README on GitHub

Details

Repository
github.com/daedalus/mcp-telegram-bot
Category
Communication & Messaging
Package
mcp-telegram-bot
Transport
STDIO
Registry
MCP registry, active

More from daedalus

Related Communication & Messaging MCP servers

View all
1ewertonslv avatarEvolution WhatsAppewertonslv/evolution-whatsapp-mcpSend and read WhatsApp messages, send media and manage instances via the Evolution API.0stars
2br0ski777 avatarEmail Deliverability Audit APIbr0ski777/email-deliverability-x402Audit email domain deliverability: SPF, DKIM, DMARC, MX. Score 0-100. x402.0stars
3br0ski777 avatarEmail Finder APIbr0ski777/email-finder-x402Find email addresses from name and company domain. x402 paid.0stars
4br0ski777 avatarEmail Verification APIbr0ski777/email-verification-x402Verify emails: syntax, MX records, disposable detection, quality score 0-100. x402 USDC.0stars
5lazymac2x avatarEmail Validatorlazymac2x/email-validator-apiCloudflare Workers MCP server: email-validator0stars
6pipeworx-io avatarCould Have Been Emailpipeworx-io/mcp-could-have-been-emailcould-have-been-email MCP — wraps StupidAPIs (keyless — no credential needed)0stars