# Telethon Plus

Telethon Plus is an MCP server for Claude Code that lets an agent control a Telegram account through MCP or HTTP. Requests run as the account logged into Telethon.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: psyb0t
- License: GPL-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/psyb0t/docker-telethon-plus
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/telethon-plus

## What it does

Telethon Plus routes MCP and HTTP API requests through a Telethon client to Telegram. Both interfaces share one server, and an agent connects through the `/mcp/` endpoint.

Running it requires Docker, `TELETHON_API_ID` and `TELETHON_API_HASH` from Telegram, plus a session string created during phone-based login. Set `TELETHON_AUTH_KEY` to restrict access; anyone who can reach the port can access the account without it. The session string also grants full account access.

## Requirements
- Needs: Docker
- Works with: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- control a Telegram account from an AI agent
- send requests to Telegram through an HTTP API
- connect an agent to Telegram over MCP

## Example prompts
- Show me the data available in my Telegram account.
- Send a Telegram message from my account.
- Connect to Telegram through the Telethon Plus server.

## Similar
- [amazon-a-plus-content](https://affpapa.org/en/nevibecode/skills/amazon-a-plus-content.md) — skill · 1400 installs
- [web-search-plus](https://affpapa.org/en/nevibecode/skills/web-search-plus.md) — skill · 1200 installs
- [thinking-five-whys-plus](https://affpapa.org/en/nevibecode/skills/thinking-five-whys-plus.md) — skill · 671 installs
- [dramatic-2000ms-plus](https://affpapa.org/en/nevibecode/skills/dramatic-2000ms-plus.md) — skill · 636 installs
- [ProxmoxMCP-Plus](https://affpapa.org/en/nevibecode/mcp/proxmoxmcp-plus.md) — MCP server · ★ 664 repo stars
- [es-plus](https://affpapa.org/en/nevibecode/mcp/es-plus.md) — MCP server · ★ 14 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
