Price Per TokenPrice Per Token

Telegram MCP Server

by chigwell

GitHub 701
0

About

Telegram MCP Server provides programmatic access to Telegram messaging functionality through the Model Context Protocol, enabling AI assistants to interact with Telegram accounts via the Telethon library. Key features: - Read and manage chats, groups, and channels with pagination and filtering - Send, modify, and delete messages and media files - Group administration including user invites, admin promotions/demotions, bans, and unbans - Create new groups and channels with configurable settings - Access contacts, participants, and account settings - Generate and retrieve invite links for groups and channels

README

[](https://opensource.org/licenses/Apache-2.0) [](https://github.com/chigwell/telegram-mcp/actions/workflows/python-lint-format.yml) [](https://github.com/chigwell/telegram-mcp/actions/workflows/docker-build.yml)

---

🤖 MCP in Action

Here's a demonstration of the Telegram MCP capabilities in Claude:

Basic usage example:

1. Example: Asking Claude to analyze chat history and send a response:

2. Successfully sent message to the group:

As you can see, the AI can seamlessly interact with your Telegram account, retrieving and displaying your chats, messages, and other data in a natural way.

---

A full-featured Telegram integration for Claude, Cursor, and any MCP-compatible client, powered by Telethon and the Model Context Protocol (MCP). This project lets you interact with your Telegram account programmatically, automating everything from messaging to group management.

---

🚀 Features & Tools

This MCP server exposes a huge suite of Telegram tools. Every major Telegram/Telethon feature is available as a tool!

Chat & Group Management

  • get_chats(page, page_size): Paginated list of chats
  • list_chats(chat_type, limit): List chats with metadata and filtering
  • get_chat(chat_id): Detailed info about a chat
  • create_group(title, user_ids): Create a new group
  • invite_to_group(group_id, user_ids): Invite users to a group or channel
  • create_channel(title, about, megagroup): Create a channel or supergroup
  • edit_chat_title(chat_id, title): Change chat/group/channel title
  • delete_chat_photo(chat_id): Remove chat/group/channel photo
  • leave_chat(chat_id): Leave a group or channel
  • get_participants(chat_id): List all participants
  • get_admins(chat_id): List all admins
  • get_banned_users(chat_id): List all banned users
  • promote_admin(chat_id, user_id): Promote user to admin
  • demote_admin(chat_id, user_id): Demote admin to user
  • ban_user(chat_id, user_id): Ban user
  • unban_user(chat_id, user_id): Unban user
  • get_invite_link(chat_id): Get invite link
  • export_chat_invite(chat_id): Export invite link
  • import_chat_invite(hash): Join chat by invite hash
  • join_chat_by_link(link): Join chat by invite link
  • subscribe_public_channel(channel): Subscribe to a public channel or supergroup by username or ID

    • Messaging

  • get_messages(chat_id, page, page_size): Paginated messages
  • list_messages(chat_id, limit, search_query, from_date, to_date): Filtered messages
  • list_topics(chat_id, limit, offset_topic, search_query): List forum topics in supergroups
  • send_message(chat_id, message): Send a message
  • reply_to_message(chat_id, message_id, text): Reply to a message
  • edit_message(chat_id, message_id, new_text): Edit your message
  • delete_message(chat_id, message_id): Delete a message
  • forward_message(from_chat_id, message_id, to_chat_id): Forward a message
  • pin_message(chat_id, message_id): Pin a message
  • unpin_message(chat_id, message_id): Unpin a message
  • mark_as_read(chat_id): Mark all as read
  • get_message_context(chat_id, message_id, context_size): Context around a message
  • get_history(chat_id, limit): Full chat history
  • get_pinned_messages(chat_id): List pinned messages
  • get_last_interaction(contact_id): Most recent message with a contact
  • create_poll(chat_id, question, options, multiple_choice, quiz_mode, public_votes, close_date): Create a poll
  • list_inline_buttons(chat_id, message_id, limit): Inspect inline keyboards to discover button text/index
  • press_inline_button(chat_id, message_id, button_text, button_index): Trigger inline keyboard callbacks by label or index
  • send_reaction(chat_id, message_id, emoji, big=False): Add a reaction to a message
  • remove_reaction(chat_id, message_id): Remove a reaction from a message
  • get_message_reactions(chat_id, message_id, limit=50): Get all reactions on a message

    • Contact Management

  • list_contacts(): List all contacts
  • **search_contacts(qu

    • Related MCP Servers

    AI Research Assistant

    AI Research Assistant

    hamid-vakilzadeh

    AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar

    Web & Search
    12 8
    Linkup

    Linkup

    LinkupPlatform

    Linkup is a real-time web search and content extraction service that enables AI assistants to search the web and retrieve information from trusted sources. It provides source-backed answers with citations, making it ideal for fact-checking, news gathering, and research tasks. Key features of Linkup: - Real-time web search using natural language queries to find current information, news, and data - Page fetching to extract and read content from any webpage URL - Search depth modes: Standard for direct-answer queries and Deep for complex research across multiple sources - Source-backed results with citations and context from relevant, trustworthy websites - JavaScript rendering support for accessing dynamic content on JavaScript-heavy pages

    Web & Search
    2 24
    Math-MCP

    Math-MCP

    EthanHenrickson

    Math-MCP is a computation server that enables Large Language Models (LLMs) to perform accurate numerical calculations through the Model Context Protocol. It provides precise mathematical operations via a simple API to overcome LLM limitations in arithmetic and statistical reasoning. Key features of Math-MCP: - Basic arithmetic operations: addition, subtraction, multiplication, division, modulo, and bulk summation - Statistical analysis functions: mean, median, mode, minimum, and maximum calculations - Rounding utilities: floor, ceiling, and nearest integer rounding - Trigonometric functions: sine, cosine, tangent, and their inverses with degrees and radians conversion support

    Developer Tools
    22 81

    Built by @aellman

    Follow us:
    Advertise | Terms of Service | Privacy Policy

    2026 68 Ventures, LLC. All rights reserved.