Better Telegram Mcp

communication MCP Server

MCP server for Telegram with dual-mode support: Bot API (httpx) for quick bot integrations and MTProto (Telethon) for full user-account access.

VerifiedReviewed
communicationcommunication
7 views9 stars4 forksMIT

Why This Matters

Discovered via github-seeds:mcp-hot and last synced 3mo ago.

VerifiedReviewed
Source
github-seeds:mcp-hot
Stars
9
Last synced
3mo ago
Install
Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions
12
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (12)

Tool

Actions

message

`send`, `edit`, `delete`, `forward`, `pin`, `react`, `search`, `history`

media

`send_photo`, `send_file`, `send_voice`, `send_video`, `download`

contact

`list`, `search`, `add`, `block`

Actions

Description

config

`status`, `set`, `cache_clear`, `setup_status`, `setup_start`, `setup_reset`, `setup_complete`

URI

Content

Project

Tagline

Mode

Storage

chat

`list`, `info`, `create`, `join`, `leave`, `members`, `admin`, `settings`, `topics`

MCP

</details> <!-- END: AUTO-GENERATED-CROSS-PROMO --> ## Table of contents - [Features](#features) - [Status](#status) - [Documentation](#documentation) - [Tools](#tools) - [Security](#security) - [Build from Source](#build-from-source) - [Trust Model](#trust-model) - [License](#license) <a href="https://glama.ai/mcp/servers/n24q02m/better-telegram-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/n24q02m/better-telegram-mcp/badge" alt="better-telegram-mcp MCP server" /> </a> ## Features - **Dual mode** -- Bot API (httpx) for bots, MTProto (Telethon) for user accounts - **6 tools** with action dispatch: `message`, `chat`, `media`, `contact`, `config`, `help` - **Auto-detect mode** -- Set bot token for bot mode, or API credentials for user mode - **Web-based OTP auth** -- Browser-based authentication with remote relay support for headless environments - **Tool annotations** -- Each tool declares `readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint` - **MCP Resources** -- Documentation available as `telegram://docs/*` resources - **Security hardened** -- SSRF protection, path traversal prevention, error sanitization ## Status > **2026-05-02 -- Architecture stabilization update** > > Past months saw significant churn around credential handling and the daemon-bridge auto-spawn pattern. This caused multi-process races, browser tab spam, and inconsistent setup UX across plugins. **As of v&lt;auto&gt;, the architecture is stable**: 2 clean modes (stdio + HTTP), no daemon-bridge layer, no auto-spawn from stdio. > > Apologies for the instability period. If you encountered issues with prior versions, please update to v&lt;auto&gt;+ and follow the current [docs/setup-manual.md](docs/setup-manual.md) -- most prior workarounds are no longer needed. > > **Related plugins from the same author**: > - [wet-mcp](https://github.com/n24q02m/wet-mcp) -- Web search + content extraction > - [mnemo-mcp](https://github.com/n24q02m/mnemo-mcp) -- Persistent AI memory > - [imagine-mcp](https://github.com/n24q02m/imagine-mcp) -- Image/video understanding + generation > - [better-notion-mcp](https://github.com/n24q02m/better-notion-mcp) -- Notion API > - [better-email-mcp](https://github.com/n24q02m/better-email-mcp) -- Email management > - [better-telegram-mcp](https://github.com/n24q02m/better-telegram-mcp) -- Telegram > - [better-godot-mcp](https://github.com/n24q02m/better-godot-mcp) -- Godot Engine > - [better-code-review-graph](https://github.com/n24q02m/better-code-review-graph) -- Code review knowledge graph > > All plugins share the same architecture -- install once, learn pattern transfers. ## Documentation Full docs at **[mcp.n24q02m.com/servers/better-telegram-mcp/](https://mcp.n24q02m.com/servers/better-telegram-mcp/)**: - [Setup](https://mcp.n24q02m.com/servers/better-telegram-mcp/setup/) -- install methods for Claude Code, Codex, Gemini CLI, Cursor, Windsurf, mcp.json - [Modes overview](https://mcp.n24q02m.com/get-started/modes-overview/) -- stdio / local-relay / remote-relay / remote-oauth - [Multi-user setup](https://mcp.n24q02m.com/get-started/multi-user/) -- per-JWT-sub credential model **Install with AI agent** -- paste this to your AI coding agent: > Install MCP server `better-telegram-mcp` following the steps at > https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-telegram-mcp/setup-with-agent.md ## Tools

Same

Only you (admin = user)