AI Agent for Telegram MCP
Integrate Telegram seamlessly with Claude, Cursor, and any MCP-compatible client using Telegram MCP. Automate chat management, messaging, contacts, and group administration with powerful tools powered by Telethon and the Model Context Protocol (MCP). Gain programmatic access to your Telegram account and streamline workflows like messaging, group management, contact organization, and more—all from a unified interface.
Full-Featured Telegram Automation
Harness the power of Telegram with comprehensive automation capabilities. Telegram MCP unlocks advanced chat and group management—including creating groups, editing titles, managing participants, promoting or banning users, and exporting invite links. Simplify operational tasks for any MCP-compatible client.
- Advanced Group Management.
- Create, edit, and manage Telegram groups or channels, including inviting, banning, or promoting users.
- Paginated Chat Retrieval.
- Access and filter chats or groups with detailed metadata for efficient oversight.
- Invite Link Handling.
- Generate, export, and import group or channel invite links for easier collaboration and onboarding.
- Robust Admin Tools.
- Leverage powerful admin functionalities such as listing admins, recent actions, and managing permissions.
Unified Messaging & Contact Integration
Send, receive, and manage all your Telegram messages and contacts from a single interface. Automate tasks like sending, replying, editing, and deleting messages, and leverage powerful contact management tools for seamless communication.
- Automated Messaging.
- Programmatically send, reply, edit, forward, and delete messages in any chat or group.
- Contact Management.
- Add, search, delete, block, and unblock contacts; import/export contact lists for streamlined outreach.
- Advanced Message Search.
- Quickly locate specific messages in any chat using advanced search and filtering options.
Personalization, Privacy & Integration
Customize your Telegram profile, manage privacy settings, and discover public channels, bots, and more. Integrate Telegram MCP with Claude, Cursor, and any MCP-compatible app for a fully automated, secure communication workflow.
- Profile Customization.
- Update your Telegram profile details and manage user photos directly from your MCP client.
- Privacy Controls.
- Get and set privacy settings, mute/unmute chats, archive conversations, and control notifications.
- Multi-Platform Integration.
- Quickly integrate with Claude, Cursor, and any MCP-compatible client for streamlined cross-platform workflows.
MCP INTEGRATION
Available Telegram MCP Integration Tools
The following tools are available as part of the Telegram MCP integration:
- get_chats
Retrieve a paginated list of your Telegram chats, including group and channel conversations.
- list_chats
List chats with additional metadata and filtering options by type or other attributes.
- get_chat
Get detailed information about a specific chat, group, or channel.
- create_group
Create a new Telegram group with a given title and list of user IDs.
- create_channel
Establish a new channel or supergroup for broadcasting or large communities.
- edit_chat_title
Change the title of a chat, group, or channel.
- delete_chat_photo
Remove the photo from a chat, group, or channel.
- leave_chat
Leave a group or channel you are a member of.
- get_participants
List all members participating in a group or channel.
- get_admins
List all admin users for a specific chat or group.
- get_banned_users
Retrieve a list of users banned from a chat or group.
- promote_admin
Promote a user to admin status within a group or channel.
- demote_admin
Demote an admin to a regular user within a group or channel.
- ban_user
Ban a user from a chat, group, or channel.
- unban_user
Unban a previously banned user from a chat or group.
- get_invite_link
Retrieve the invite link for a group or channel.
- export_chat_invite
Export a new or existing invite link for a chat or group.
- import_chat_invite
Join a chat or group using an invite hash.
- join_chat_by_link
Join a chat or group using a public or private invite link.
- get_messages
Retrieve a paginated list of messages from a chat, group, or channel.
- list_messages
List messages with filtering by search query, date range, or other criteria.
- send_message
Send a message to any chat, group, or channel.
- reply_to_message
Reply directly to a specific message in a chat.
- edit_message
Edit a previously sent message in a chat.
- delete_message
Delete a message you have sent in a chat or group.
- forward_message
Forward a message from one chat to another.
- pin_message
Pin a message to the top of a chat, group, or channel.
- unpin_message
Unpin a previously pinned message from a chat.
- mark_as_read
Mark all messages as read in a chat or group.
- get_message_context
Retrieve surrounding context for a specific message in a chat.
- get_history
Get the full message history for a chat or group.
- get_pinned_messages
List all pinned messages in a chat, group, or channel.
- get_last_interaction
Retrieve the most recent message with a specified contact.
- list_contacts
List all contacts saved in your Telegram account.
- search_contacts
Search through your Telegram contacts by name or query.
- add_contact
Add a new contact to your Telegram account.
- delete_contact
Remove a contact from your account.
- block_user
Block a user from contacting you on Telegram.
- unblock_user
Unblock a user previously blocked on Telegram.
- import_contacts
Import multiple contacts to your Telegram account in bulk.
- export_contacts
Export all your contacts as a JSON file.
- get_blocked_users
List all users you have blocked.
- get_contact_ids
List the IDs of all your contacts.
- get_direct_chat_by_contact
Find the direct chat associated with a specific contact.
- get_contact_chats
List all chats you have with a specific contact.
- get_me
Retrieve your own Telegram user information.
- update_profile
Update your Telegram profile details such as name and about.
- delete_profile_photo
Remove your current profile photo.
- get_user_photos
Get a list of profile photos for any user.
- get_user_status
Retrieve the online status of any user.
- get_media_info
Get information about media contained in a message.
- search_public_chats
Search public chats, channels, or bots by query.
- search_messages
Search for messages containing specific text in a chat.
- resolve_username
Resolve a Telegram username to a user or chat ID.
- get_sticker_sets
List all sticker sets available to your account.
- get_bot_info
Retrieve information about a specific Telegram bot.
- set_bot_commands
Set commands for a bot account you own or manage.
- get_privacy_settings
Retrieve your current Telegram privacy settings.
- set_privacy_settings
Update your privacy settings, including allowed or disallowed users.
- mute_chat
Mute notifications for a specific chat or group.
- unmute_chat
Unmute notifications for a previously muted chat.
- archive_chat
Archive a chat or group to keep your conversation list organized.
- unarchive_chat
Unarchive a chat or group previously moved to archive.
- get_recent_actions
Get recent admin or moderation actions in a group or channel.
Connect Your Telegram with FlowHunt AI
Connect your Telegram to a FlowHunt AI Agent. Book a personalized demo or try FlowHunt free today!
What is Telegram MCP Server by Chigwell
Telegram MCP Server by Chigwell is a robust integration platform that brings together the advanced capabilities of Telegram with Claude, Cursor, and any Model Context Protocol (MCP)-compatible client. Powered by Telethon and MCP, this server exposes a comprehensive suite of Telegram tools, allowing users to access and automate nearly every major feature of Telegram. With this integration, users can manage chats and groups, automate message handling, and connect AI agents or bots directly to Telegram in a secure and scalable manner. The service is designed for developers and organizations seeking seamless, programmatic access to Telegram’s functionality, making it ideal for building custom bots, group management tools, or integrating Telegram with AI workflows.
Capabilities
What we can do with Telegram MCP Server
Telegram MCP Server enables a wide range of automation and integration use cases with Telegram. Developers and organizations can leverage its features for chat and group management, automated message handling, and seamless integration with AI agents or external services. Here are some of the key capabilities:
- Automated Chat Management
- Effortlessly manage Telegram chats, including sending, receiving, and organizing messages.
- Group Administration Tools
- Automate group membership, permissions, and moderation tasks for efficient community management.
- AI Integration
- Connect AI models and agents to Telegram, enabling intelligent bots and conversational workflows.
- Custom Notifications
- Set up automated alerts and notifications for user activity, system events, or external triggers.
- Secure API Integration
- Securely connect Telegram functionality with external applications and services using MCP.
How AI Agents Benefit from Telegram MCP Server
AI agents can leverage Telegram MCP Server to interact with users in real time, automate responses, and manage conversations at scale. By connecting directly to Telegram, AI agents can provide intelligent chatbots, facilitate group collaborations, and execute tasks based on chat interactions. The server’s full-featured API ensures AI-driven automation and seamless communication, making it an invaluable tool for advanced AI workflows and user engagement.