mcp-tg

MCP server for Telegram Client API (MTProto). Provides 80 tools, 4 resources, 3 prompts, and argument completions for comprehensive Telegram account management.

Uses gotd/td for MTProto protocol — this is a user account client, not a bot.

📖 Full documentation: mcp-tg.lexfrei.dev

Install

Homebrew (macOS, Linux) — also installs a brew services unit for the shared HTTP daemon:

brew install lexfrei/tap/mcp-tg

APT (Debian, Ubuntu) — also ships a systemd user unit for the shared HTTP daemon:

curl --fail --silent --show-error --location https://apt.lexfrei.dev/lexfrei.asc \
  | sudo gpg --dearmor --output /usr/share/keyrings/lexfrei.gpg

sudo tee /etc/apt/sources.list.d/lexfrei.sources >/dev/null <<'EOF'
Types: deb
URIs: https://apt.lexfrei.dev
Suites: stable
Components: main
Signed-By: /usr/share/keyrings/lexfrei.gpg
EOF

sudo apt update && sudo apt install mcp-tg

Container:

docker pull ghcr.io/lexfrei/mcp-tg:latest

Binary: darwin, linux and windows archives for amd64 and arm64 are on the releases page,…