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
Telegram MCP server
chaindeadTelegram MCP for managing dialogs, messages, drafts, read statuses, and more.
Caulo
PatryCaulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au
Email sending MCP 💌
ykhliThe official MCP server to send emails and interact with Resend
Discord MCP Server
hanwegMCP server for discord bot
Discord Mcp
SaseQA MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automation capabilities.
Comments