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.
Aún no hay reseñas. ¡Sé el primero en reseñar!
Inicia sesión para unirte a la conversación
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)
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)
List forum topics in supergroups. Parameters: chat_id (int), limit (int), offset_topic (int), search_query (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)
Context around a message. Parameters: chat_id (int), message_id (int), context_size (int)
Full chat history. Parameters: chat_id (int), limit (int)
List pinned messages. Parameters: chat_id (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 to discover button text/index. Parameters: chat_id (int or string), message_id (int), limit (int)
Trigger inline keyboard callbacks by label or index. Parameters: chat_id (int or string), message_id (int), button_text (string), button_index (int)
Add a reaction to a message. Parameters: chat_id (int), message_id (int), emoji (string), big (bool)
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)
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.