The simplest MCP server for interacting with Telegram
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"simple-telegram-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
<a id="top"></a> <div align="center"> <a href="https://github.com/elyase/simple-telegram-mcp"> <img src="logo.png" alt="Logo" width="110" height="110"> </a> <h1>Simple Telegram MCP</h1> </div> ## ✨ Example use cases - **Automate tasks**: “Look up the weather forecast and send it to my family group” - **Stay on top of things**: “Review my unread messages, give me the highlights, and queue polite replies” - **Polish before sending**: “Read Tony’s latest note in the Family channel, craft three informal reply drafts, and leave them for me to send.” ## 🚀 Quick Start ### Automatic client configuration | Client | Command | |-------------------|---------------------------------------------------| | Cursor | `uvx simple-telegram-mcp --install cursor` | | Claude Desktop | `uvx simple-telegram-mcp --install claude-desktop`| | Claude Code | `uvx simple-telegram-mcp --install claude-code` | | Gemini CLI | `uvx simple-telegram-mcp --install gemini-cli` | | VS Code (global) | `uvx simple-telegram-mcp --install vscode` | | MCP JSON (stdout) | `uvx simple-telegram-mcp --install mcp-json` | | OpenAI Codex CLI | `uvx simple-telegram-mcp --install codex-cli` | ### Authorize Telegram ```bash uvx simple-telegram-mcp --login ``` > > ✨ Heads-up: the login flow is zero drama. You’ll pop in your phone number, Telegram will DM you a code, you paste it back here, and you’re in. > 💡 When using Simple Telegram MCP through an assistant, run `telegram_auth_start` followed by `telegram_auth_confirm` right inside the conversation as soon as an `AUTH_REQUIRED` message appears. The assistant will guide you through entering your phone, code, and (if needed) two-factor password. ## 🛠️ Tools | Tool | Description | |--------------------------|----------------------------------------------…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.