Telegram MCP Server
JSON →Interact with the Telegram messaging service to send and receive messages.
Install
uvx telegram-mcp`, Tools · 66
- list_accounts List configured Telegram accounts
- list_chats List Telegram chats and groups
- get_chat_info Inspect chat metadata
- create_group Create a new Telegram group
- create_channel Create a new Telegram channel
- join_chat Join a Telegram chat or group
- leave_chat Leave a Telegram chat or group
- invite_users Invite users to a chat or group
- manage_admins Manage chat administrators
- ban_user Ban a user from a chat
- set_default_permissions Set default chat permissions
- set_slow_mode Set slow mode interval in a chat
- manage_topics Manage forum topics in a group
- create_invite_link Create an invite link for a chat
- get_common_chats Get common chats with a user
- get_read_receipts Get read receipts for messages
- get_message_link Get a direct link to a message
- send_message Send a message to a chat
- schedule_message Schedule a message for later delivery
- edit_message Edit an existing message
- delete_message Delete a message
- forward_message Forward a message to another chat
- pin_message Pin a message in a chat
- unpin_message Unpin a message from a chat
- mark_read Mark messages as read
- reply_to_message Reply to a specific message
- search_messages Search for messages in a chat
- get_message_context Inspect context around a message
- create_poll Create a poll in a chat
- manage_reactions Manage message reactions
- inspect_inline_buttons Inspect inline keyboard buttons on a message
- press_inline_callback Press an inline button callback
- list_contacts List Telegram contacts
- search_contacts Search for contacts
- add_contact Add a new contact
- delete_contact Delete a contact
- block_user Block a user
- unblock_user Unblock a user
- import_contacts Import contacts from a file
- export_contacts Export contacts to a file
- get_direct_chat Inspect direct chat with a contact
- find_recent_contact_interactions Find recent interactions with a contact
- send_file Send a file to a chat
- download_media Download media from a message
- upload_file Upload a file to Telegram
- send_voice_note Send a voice note to a chat
- send_sticker Send a sticker to a chat
- send_gif Send a GIF to a chat
- inspect_message_media Inspect media attached to a message
- get_account_info Get your own Telegram account info
- update_profile Update your Telegram profile fields
- set_profile_photo Set a profile photo
- delete_profile_photo Delete a profile photo
- get_privacy_settings Inspect privacy settings
- get_user_info Get information about a user
- get_user_photos Get a user's profile photos
- get_user_status Get a user's online status
- manage_bot_commands Manage bot commands for a chat
- list_folders List Telegram folders
- create_folder Create a new Telegram folder
- update_folder Update an existing Telegram folder
- reorder_folders Reorder Telegram folders
- delete_folder Delete a Telegram folder
- save_draft Save a draft message
- list_drafts List saved draft messages
- clear_drafts Clear all draft messages
Environment variables
TELEGRAM_API_IDTELEGRAM_PROXY_HOSTTELEGRAM_PROXY_PORTTELEGRAM_PROXY_SECRETYOUR_API_ID
Links
★ 1,127 GitHub stars