Telegram MCP Server

What is Telegram MCP Server?

A Telegram CLI with background sync and an optional MCP server for your personal account (MTProto, not bot API). It lets you manage chats, messages, media, and contacts from the command line and expose Telegram functionality to MCP-compatible clients.

How to use Telegram MCP Server?

Install via npm install -g @kfastov/tgcli or brew install kfastov/tap/tgcli. Authenticate with API credentials from my.telegram.org/apps using tgcli auth, then enable the MCP server by setting tgcli config set mcp.enabled true and run tgcli server. Configure host/port with tgcli config set mcp.host and tgcli config set mcp.port.

Key features of Telegram MCP Server

• Background sync and archive backfill
• Optional MCP server for AI integration
• Send and receive text and files
• Search messages across chats and channels
• Download media files
• Manage contacts, channels, and groups

Use cases of Telegram MCP Server

• Automate message sending and file sharing
• Archive Telegram chats for offline search
• Integrate Telegram into AI-powered workflows via MCP
• List and manage channels, groups, and contacts

FAQ from Telegram MCP Server

Does it use the Bot API or MTProto?

It uses MTProto for your personal account, not the Bot API.

How do I authenticate?

Get API credentials from my.telegram.org/apps, then run tgcli auth and follow the prompts.

Where is data stored?

Config, sessions, and a messages database are stored in the OS app-data directory. Override with the TGCLI_STORE environment variable.

How do I enable the MCP server?

Set tgcli config set mcp.enabled true, optionally change the bind address, and run tgcli server.

What is the default MCP endpoint?

The server binds to http://127.0.0.1:8080/mcp by default. Host and port can be changed via tgcli config set mcp.host and tgcli config set mcp.port.