Telegram MCP Server provides a bridge between Claude and Telegram messaging, enabling direct interaction with Telegram chats without leaving the conversation interface. Built using Python, Telethon, and the MCP Python SDK, it exposes three core tools: retrieving chat lists, fetching messages from specific chats, and sending messages to contacts. The implementation authenticates with the Telegram API using credentials stored in environment variables and integrates seamlessly with Claude Desktop through a simple configuration. Particularly valuable for users who want to monitor or participate in Telegram conversations while working with Claude.
No reviews yet. Be the first to review!
Sign in to join the conversation
Highlight AIGet a paginated list of chats. Parameters: page (int), page_size (int)
List chats with metadata and filtering. Parameters: chat_type (string), limit (int)
Detailed info about a chat. Parameters: chat_id (int)
Create a new group. Parameters: title (string), user_ids (list of int)
Invite users to a group or channel. Parameters: group_id (int), user_ids (list of int)
Create a channel or supergroup. Parameters: title (string), about (string), megagroup (bool)
Change chat/group/channel title. Parameters: chat_id (int), title (string)
Remove chat/group/channel photo. Parameters: chat_id (int)
Leave a group or channel. Parameters: chat_id (int)
List all participants. Parameters: chat_id (int)
List all admins. Parameters: chat_id (int)
List all banned users. Parameters: chat_id (int)
Promote user to admin. Parameters: chat_id (int), user_id (int)
Demote admin to user. Parameters: chat_id (int), user_id (int)
Ban user. Parameters: chat_id (int), user_id (int)
Unban user. Parameters: chat_id (int), user_id (int)
Get invite link. Parameters: chat_id (int)
Export invite link. Parameters: chat_id (int)
Join chat by invite hash. Parameters: hash (string)
Join chat by invite link. Parameters: link (string)
Subscribe to a public channel or supergroup by username or ID. Parameters: channel (string)
Get paginated messages. Parameters: chat_id (int), page (int), page_size (int)
Filtered messages. Parameters: chat_id (int), limit (int), search_query (string), from_date (string), to_date (string)
Send a message. Parameters: chat_id (int), message (string)
Reply to a message. Parameters: chat_id (int), message_id (int), text (string)
Edit your message. Parameters: chat_id (int), message_id (int), new_text (string)
Delete a message. Parameters: chat_id (int), message_id (int)
Forward a message. Parameters: from_chat_id (int), message_id (int), to_chat_id (int)
Pin a message. Parameters: chat_id (int), message_id (int)
Unpin a message. Parameters: chat_id (int), message_id (int)
Mark all as read. Parameters: chat_id (int)
Full chat history. Parameters: chat_id (int), limit (int)
Most recent message with a contact. Parameters: contact_id (int)
Create a poll. Parameters: chat_id (int), question (string), options (list of string), multiple_choice (bool), quiz_mode (bool), public_votes (bool), close_date (string)
Inspect inline keyboards. Parameters: chat_id (int or string), message_id (int, optional), limit (int)
Trigger inline keyboard callbacks. Parameters: chat_id (int or string), message_id (int, optional), button_text (string, optional), button_index (int, optional)
Add a reaction to a message. Parameters: chat_id (int), message_id (int), emoji (string), big (bool, optional)
Remove a reaction from a message. Parameters: chat_id (int), message_id (int)
Get all reactions on a message. Parameters: chat_id (int), message_id (int), limit (int, optional)
List all contacts.
Search contacts. Parameters: query (string)
Add a contact. Parameters: phone (string), first_name (string), last_name (string)
Delete a contact. Parameters: user_id (int)
Block a user. Parameters: user_id (int)
Unblock a user. Parameters: user_id (int)
Bulk import contacts. Parameters: contacts (list of dict)
Export all contacts as JSON.
List blocked users.
List all contact IDs.
Find direct chat with a contact. Parameters: contact_query (string)
List all chats with a contact. Parameters: contact_id (int)
Get your user info.
Update your profile. Parameters: first_name (string), last_name (string), about (string)
Set a profile photo from an allowed root path. Parameters: file_path (string)
Remove your profile photo.
Get a user's profile photos. Parameters: user_id (int), limit (int)
Get a user's online status. Parameters: user_id (int)
Get info about media in a message. Parameters: chat_id (int), message_id (int)
