Telethon Plus MCP Server

Your Telegram account, but it takes HTTP requests. Wraps Telethon - the real MTProto userbot client, not that neutered Bot API garbage - behind a JSON HTTP API and a Model Context Protocol endpoint.

People who work with docker, http api and telegram and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-01 · ★ 2 · #99 OF 105 MAINTAINED COMMUNICATION · VERIFIED 2026-09-18

WTFPL · Python servers · how we verify → /methodology

01 · Install Telethon Plus

before you install - you'll need

Set TELETHON_API_ID, TELETHON_API_HASH before connecting.

Docker

docker run -i --rm docker.io/psyb0t/telethon-plus:v0.5.7

Claude Desktop - add to config

{
  "mcpServers": {
    "psyb0t-docker-telethon-plus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/psyb0t/telethon-plus:v0.5.7"
      ]
    }
  }
}

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as container (OCI image) - can be sandboxed away from your filesystem

license WTFPL - declared in the repository

registry namespace io.github.psyb0t is GitHub-verified and matches the repo owner

03 · What Telethon Plus can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.5.7 · 2026-08-01

v0.5.6 · 2026-07-27

v0.5.5 · 2026-07-27

04 · Who maintains Telethon Plus

Telethon Plus is maintained by psyb0t. We track 13 MCP servers from psyb0t - 13 actively maintained, 126 combined GitHub stars, oldest repo from Jun 2025. Full record: all servers from psyb0t.

05 · Facts

repository: github.com/psyb0t/docker-telethon-plus
category: communication - ranked #99 of 105 actively-maintained communication servers as of 2026-09-18.
release cadence: 10+ releases in the last 90 days (latest 2026-08-01)
registry: io.github.psyb0t/telethon-plus (active, first published 2026-07-26 · 6 versions)
packages: oci:docker.io/psyb0t/telethon-plus:v0.5.7

06 · Telethon Plus FAQ

What is Telethon Plus?

Your Telegram account, but it takes HTTP requests. Wraps Telethon - the real MTProto userbot client, not that neutered Bot API garbage - behind a JSON HTTP API and a Model Context Protocol endpoint.

Is Telethon Plus still maintained?

Yes - as of 2026-09-18, its last commit was 2026-08-01 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install Telethon Plus?

Run `docker run -i --rm docker.io/psyb0t/telethon-plus:v0.5.7`. The README documents 2 environment variables (TELETHON_API_ID, TELETHON_API_HASH) to set first. Set TELETHON_API_ID, TELETHON_API_HASH before connecting. You can also paste the ready-made client config above.

07 · Alternatives to Telethon Plus

Alternatives to Telethon Plus

Maintained communication servers if Telethon Plus isn't the fit.

Pairs well with

Servers that cover what Telethon Plus doesn't - only shown when the pairing reason fits the companion.

More communication MCP servers · Slack (pulsemcp) · Twist · Aiogram MCP · Mup · Runframe MCP Server

More Python MCP servers · SAGE Wrapper · Markdown Vault MCP · Scholar MCP (pvliesdonk) · Godot Lens · see all