Telegram MCP Server

@kfastov

Repository

Basic information

About Telegram MCP Server

Telegram user console client and archiver

#telegram #mcp#telegram-client#ai-agents #mcp-server #fastmcp

Telegram MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Telegram MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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`.

Comments

More Communication MCP servers

Pidgeon

Email inboxes for AI agents. Give an agent its own address in one call; it sends, receives and replies in threads, waits for a sign-up code and gets it back already extracted, and hands a conversation to a person when it

Mobile Text Alerts SMS

Mobile Text Alerts

Official Mobile Text Alerts server. Send and schedule SMS, manage subscribers and groups, and complete carrier registration from any MCP-compatible AI assistant.

Canarics

AI call analysis and voice agents for sales teams. This MCP server lets a team's own AI assistant read minute usage, agents, call summaries and daily stats, look up caller history, schedule consent-gated AI callbacks, an

uplika

Hosted MCP server that lets your AI agent post to Threads, Instagram, YouTube, Facebook, TikTok, Pinterest, Bluesky, Telegram, Discord, Ghost and Naver Blog. Setup for each agent.

JooVoice

Give your AI agent a phone. JooVoice makes real calls for you in 80+ languages, with local accents, across 67 countries, like booking a table, moving an appointment or chasing a refund, and sends back what happened. Call