Telegram MCP Server
@kfastov
About Telegram MCP Server
Telegram user console client and archiver
Config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryTools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
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.
Frequently asked questions
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`.
Basic information
More Communication MCP servers
Twilio MCP Monorepo
twilio-labsMonorepo providing 1) OpenAPI to MCP Tool generator 2) Exposing all of Twilio's API as MCP Tools
Telegram MCP server
chaindeadTelegram MCP for managing dialogs, messages, drafts, read statuses, and more.
MailStream
Sponge LabsThe first MCP server for physical mail. Give any MCP-compatible AI agent the ability to send real postcards and letters, verify addresses, manage mailing lists and artwork, and track direct mail campaigns. Remote Streama
Discord MCP Server
hanwegMCP server for discord bot
Gmail
shinzo-labsMCP Implementation for Gmail Services
Comments