chaindead/telegram-mcp
FreeTelegram API 集成，访问用户数据、管理对话、检索消息和处理已读状态。
FreeFree tier
About chaindead/telegram-mcp
Telegram MCP server is a bridge between the Telegram API and AI assistants, built on the Model Context Protocol (MCP). It enables AI assistants like Claude Desktop or Cursor to interact with Telegram by managing dialogs, retrieving messages, sending drafts, marking read statuses, and accessing account information. The server is open source and supports multiple installation methods including Homebrew, NPX, and manual builds from source.
Key Features
Get current account information (tg_me tool)
List dialogs with optional unread filter (tg_dialogs tool)
Mark dialog as read (tg_read tool)
Retrieve messages from specific dialog (tg_dialog tool)
Send draft messages to any dialog (tg_send tool)
Monitor specific chats for updates
Analyze and categorize dialogs
Pros & Cons
Pros
- Integrates Telegram with AI assistants via MCP for natural language control
- Open source and free to use (MIT license)
- Supports multiple installation methods: Homebrew, NPX, and from source
- Provides authentication and client configuration guidance
- Useful for automating Telegram message management and organization
Cons
- Requires Telegram API credentials (app_id and api_hash) which must be obtained manually
- Misuse may lead to account suspension per Telegram API Terms of Service
- Only works with MCP-compatible AI assistants (e.g., Claude Desktop, Cursor)
- No built-in GUI; requires command-line or configuration setup
Best For
Message Management: Check unread important messages, summarize unread messages, prepare draft responsesOrganization: Analyze dialogs, suggest folder structure, categorize chats by importance or work-related topicsCommunication: Monitor specific chat for updates, draft polite responses, check for unanswered questions
FAQ
What is MCP?
The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop or Cursor, connect to external tools and data sources. It provides a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.
How do I install telegram-mcp?
You can install via Homebrew on macOS/Linux: 'brew install chaindead/tap/telegram-mcp', or run directly using npx: 'npx -y @chaindead/telegram-mcp', or download from GitHub Releases for macOS/Linux/Windows.
What is needed to authenticate with Telegram?
You need to obtain a Telegram API ID and API hash from my.telegram.org, then set them as environment variables TG_APP_ID and TG_API_HASH. Run the auth command to complete the login process.