chaindead/telegram-mcp
Overview
A Python tool for Telegram API integration, enabling access to user data, dialog management (chats, channels, groups), message retrieval, sending, and read status handling.
Capabilities
- • filesystem integration
- • github integration
- • mcp client integration
- • workflow automation support
Best For
Python-based Telegram API integration tool for user data access, dialog management, message handling.
Decision Snapshot
Usage
available
Docs
5 links
Config
5 strong hints
Capabilities
4 key capabilities detected
- • GitHub stars: 317
- • Forks: 42
- • Source provenance count: 2
- • Active signal: Updated this week from lifecycle signals.
- • Last seen: 4/15/2026
- • Published: 3/18/2026
Usage
docker run -it --rm \ && -e TELEGRAM_API_ID="YOUR_API_ID" \ && -e TELEGRAM_API_HASH="YOUR_API_HASH" \ && -e TELEGRAM_SESSION_STRING="YOUR_SESSION_STRING" \
Features
- • **Run Compose:**
- • Press Ctrl+C to stop the server.
- • Replace placeholders with your actual credentials.
- • The -it flags are crucial for interacting with the server.
- • "Show my recent chats"
- • "Send 'Hello world' to chat 123456789"
- • "Add contact with phone +1234567890, name John Doe"
- • "Create a group 'Project Team' with users 111, 222, 333"
Use Cases
- • Supports capabilities such as: filesystem integration; github integration; mcp client integration.
- • Common usage themes: mcp, curated, markdown-list, awesome-mcp-servers-punkpeye.
Supported Clients / Integrations
- • filesystem integration
- • github integration
- • mcp client integration
- • workflow automation support
Compatibility Signals
- • GitHub: supports (Detected in parser config/capability hints.)
Prompt Examples
example
• docker run -it --rm \ && -e TELEGRAM_API_ID="YOUR_API_ID" \ && -e TELEGRAM_API_HASH="YOUR_API_HASH" \ && -e TELEGRAM_SESSION_STRING="YOUR_SESSION_STRING" \
Notes / Requirements
- • Primary language: Go
- • License: MIT
- • Documentation coverage: high
- • Parser coverage score: 1.00
- • Source feeds: Awesome MCP Servers (punkpeye)
- • Topic cluster: general
Official Links
Source Information
You can verify all information on this page against the source repository above.
Related MCP Tools
wyattjoh/imessage-mcp
A Model Context Protocol (MCP) server for reading iMessage data from macOS, featuring message retrieval, chat listing, and contact management.
lharries/whatsapp-mcp
An MCP server for searching personal WhatsApp messages, contacts, and sending messages to individuals or groups.
conarti/mattermost-mcp
An MCP server for the Mattermost API, enabling channel listing, message read/post, thread and reaction management, and topic monitoring. Supports flexible configuration via CLI args, environment variables, or config files.
Danielpeter-99/calcom-mcp
An MCP server for Calcom that enables managing event types, creating bookings, and accessing scheduling data via LLMs.
What To Do Next
Continue from this tool into a workflow and a learn guide to shorten implementation time.