Labsco
kfastov logo

Telegram MCP Server

★ 40

from kfastov

Interact with a Telegram account using the user client API, allowing AI assistants to manage chats and messages.

🔥🔥🔥✓ VerifiedFreeQuick setup
#maps

tgcli

Telegram CLI with background sync and an optional MCP server for your personal account (MTProto, not bot API).

Authentication

Get Telegram API credentials:

  1. Go to https://my.telegram.org/apps
  2. Log in with your phone number
  3. Create a new application
  4. Copy api_id and api_hash

Then authenticate:

Copy & paste — that's it
tgcli auth

Commands

Copy & paste — that's it
tgcli auth           Authentication and session setup
tgcli config         View and edit config
tgcli sync           Archive backfill and realtime sync
tgcli server         Run background sync service (MCP optional)
tgcli service        Install/start/stop/status/logs for background service
tgcli channels       List/search channels
tgcli messages       List/search messages
tgcli send           Send text or files
tgcli media          Download media
tgcli topics         Forum topics
tgcli tags           Channel tags
tgcli metadata       Channel metadata cache
tgcli contacts       Contacts and people
tgcli groups         Group management
tgcli doctor         Diagnostics and sanity checks

Use tgcli [command] --help for details. Add --json for machine-readable output.

MCP (optional)

Enable it via config:

Copy & paste — that's it
tgcli config set mcp.enabled true

By default the server binds to http://127.0.0.1:8080/mcp. To change it:

Copy & paste — that's it
tgcli config set mcp.host 127.0.0.1
tgcli config set mcp.port 8080

Then run tgcli server and point your client at the configured address.