telegram-mcp-server

View on GitHub

MCP server implementation for Telegram

27 stars JavaScriptAI & Machine Learning Updated Nov 4, 2025

ai-agentsfastmcpmcpmcp-servertelegramtelegram-client

Documentation

tgcli

Telegram CLI with background sync and an optional MCP server for your personal account (MTProto, not bot API).

Installation

bash

npm install -g @kfastov/tgcli

bash

brew install kfastov/tap/tgcli

Authentication

Get Telegram API credentials:

1. Go to https://my.telegram.org/apps

2. Log in with your phone number

3. Create a new application

4. Copy `api_id` and `api_hash`

Then authenticate:

bash

tgcli auth

Quick start

bash

tgcli auth
tgcli sync --follow
tgcli messages list --chat @username --limit 20
tgcli messages search "course" --chat @channel --source archive
tgcli send text --to @username --message "hello"
tgcli server

Commands

bash

tgcli auth           Authentication and session setup
tgcli config         View and edit config
tgcli sync           Archive backfill and realtime sync
tgcli server         Run background sync service (MCP optional)
tgcli service        Install/start/stop/status/logs for background service
tgcli channels       List/search channels
tgcli messages       List/search messages
tgcli send           Send text or files
tgcli media          Download media
tgcli topics         Forum topics
tgcli tags           Channel tags
tgcli metadata       Channel metadata cache
tgcli contacts       Contacts and people
tgcli groups         Group management
tgcli doctor         Diagnostics and sanity checks

Use `tgcli [command] --help` for details. Add `--json` for machine-readable output.

MCP (optional)

Enable it via config:

bash

tgcli config set mcp.enabled true

By default the server binds to `http://127.0.0.1:8080/mcp`. To change it:

bash

tgcli config set mcp.host 127.0.0.1
tgcli config set mcp.port 8080

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

Frequently asked questions

What is telegram-mcp-server?

telegram-mcp-server is MCP server implementation for Telegram

How do I install telegram-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is telegram-mcp-server open source?

Yes — it is hosted on GitHub at https://github.com/kfastov/telegram-mcp-server and has 27 stars.

Related MCP tools

anything-llm

The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

50,686 JavaScript

ai-agentscustom-ai-agentsdeepseek+16

cursor-talk-to-figma-mcp

CTTF: MCP integration between Cursor and Figma, allowing Cursor Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

5,539 JavaScript

agentagenticagentic-ai+11

firecrawl-mcp-server

🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients. JavaScript-based implementation.

4,847 JavaScript

batch-processingclaudecontent-extraction+11

mcp-jetbrains

A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio

926 JavaScript

ideintellijjetbrains+3

linear-mcp-server

A server that integrates Linear's project management system with the Model Context Protocol (MCP) to allow LLMs to interact with Linear.

331 JavaScript

anthropiclinearmcp+2

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Ag...

18,776 TypeScript

ai-agentai-agent-toolsai-agents+10

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP