mcp-telegram

Telegram MCP server (MTProto). Connect Claude, Cursor, Claude Code, VS Code, Codex, Cline, Windsurf to a real Telegram account — read/search/send messages, moderate channels, manage stories/contacts/folders, transcribe voice, and call any raw MTProto method. Browser-based sign-in. 100+ tools.

→ beautyfree/mcp-telegram · listed on github_topic

Is this your MCP?

Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find.

Install from

github_topic Glama

M8ven verifies MCPs across every public registry — install directly from whichever one you prefer.

// key findings

✅

No credential exfiltration, no sensitive file access, no obfuscation

Static analysis found nothing flowing your secrets to unexpected places.

✅

Open source with a license and README

Anyone can audit the code, the license is declared, and the publisher documents what it does.

// required environment variables

This server reads these from process.env. You'll be asked to provide them before it can run.

configLOG_LEVEL— no info debug for verbose stderr.

configMCP_TELEGRAM_DOWNLOADS— TELEGRAM_AGENT_DOWNLOADS no $TELEGRAM_AGENT_HOME/downloads Where download_media / download_profile_photo save files. Legacy still accepted.

configMCP_TELEGRAM_HOME— TELEGRAM_AGENT_HOME no ~/.telegram-agent State + per-account session storage. Legacy still accepted. If only ~/.mcp-telegram exists from a previous install, it's used automatically.

configMCP_TELEGRAM_READONLY— 1 Hide every destructive / mutating tool.

configTELEGRAM_AGENT_DOWNLOADS— no $TELEGRAM_AGENT_HOME/downloads Where download_media / download_profile_photo save files. Legacy MCP_TELEGRAM_DOWNLOADS still accepted.

configTELEGRAM_AGENT_HOME— no ~/.telegram-agent State + per-account session storage. Legacy MCP_TELEGRAM_HOME still accepted. If only ~/.mcp-telegram exists from a previous install, it's used automatically.

configTELEGRAM_API_HASH— env =abc...

configTELEGRAM_API_ID— env =123456 \

// full audit trail

The full breakdown of what we checked, the deductions that landed, the network hosts, the dependency advisories, and concrete fix guidance is available to verified publishers.

// improvement guidance — verified publishers only

We have 1 concrete improvement we can share with the publisher of this MCP. Each comes with specific guidance to raise the trust score.

// embed badge in your README

[![M8ven Score](https://m8ven.ai/badge/mcp/beautyfree-mcp-telegram-b6dvzv)](https://m8ven.ai/mcp/beautyfree-mcp-telegram-b6dvzv)

commit: f61b257a89b21a1f42a98bbefcbf7a24a83a53d8

code hash: 192a88035c0dc25ce5442d19db59fbd52bbde4eca0d3ae436dc24a675808c7e8

verified: 6/15/2026, 1:31:13 PM

view raw JSON →