Handles configuration management through environment variables, specifically for storing Telegram API credentials including API ID, API hash, and phone number.
Enables interaction with Telegram messaging platform, providing tools to search channels by keywords, list available channels, retrieve messages from channels, and filter messages by regex patterns.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Telegram MCP Serversearch for channels about AI news"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tgcli
Telegram CLI with background sync and an optional MCP server for your personal account (MTProto, not bot API).
Installation
Related MCP server: VRChat MCP Server
Authentication
Get Telegram API credentials:
Go to https://my.telegram.org/apps
Log in with your phone number
Create a new application
Copy
api_idandapi_hash
Then authenticate:
Quick start
Commands
Use tgcli [command] --help for details. Add --json for machine-readable output.
MCP (optional)
Enable it via config:
By default the server binds to http://127.0.0.1:8080/mcp. To change it:
Then run tgcli server and point your client at the configured address.
Configuration & Store
The tgcli store lives in the OS app-data directory and contains config.json, sessions, and messages.db.
Override the location with TGCLI_STORE.
Legacy version: see MIGRATION.md.