Chatroost — unofficial Telegram MCP server

Name: Chatroost — unofficial Telegram MCP server
Author: mcp-telegram

作者：mcp-telegram版本 1.45.1i★ 69i电脑或云端

注册名称io.github.mcp-telegram/mcp-telegram

安装方法

What it does

Unofficial Telegram MCP server — read, search, reply and react in your own Telegram account.

Connects 电脑或云端
Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: Needs TELEGRAM_API_ID, TELEGRAM_API_HASH
Category 聊天与邮件

安装

选择你使用的 AI 应用，然后复制设置。

通过 5/5 项检查 · 你的提问会经过开发者的服务器（mcp.mcp-telegram.com） · ✓ 命令已检查 2026年11月13日

第一步：你用哪个 AI？

Claude网页 · 应用 · 手机ChatGPT网页Claude Code终端Cursor代码编辑器VS Code代码编辑器其他其他应用

选择你用的应用，步骤会显示在下方。

可连接 Claude · 约 2 分钟

不需要密钥，不用安装程序 · 在 claude.ai 或桌面应用设置一次，即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者（Owner）添加

打开 Claude 的 Connectors 页面
CustomizeConnectors
已完成
点击“Add” → “Custom” → “Web”，填写这 2 项
把这里的内容复制到 Claude 中同名的输入框，然后点击 Continue
Name · 名称Chatroost — unofficial Telegram MCP server
Remote MCP server URL · 地址https://mcp.mcp-telegram.com/mcp
在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择（Sign in now、Sign in when needed 或 No sign in），然后点击 Add
已完成
在聊天中开启
+ConnectorsChatroost — unofficial Telegram MCP server
已完成
试一试
用 Chatroost — unofficial Telegram MCP server 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 Claude 说正在使用 Chatroost — unofficial Telegram MCP server，或回答中出现 Chatroost — unofficial Telegram MCP server 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

能否连接 ChatGPT 取决于方案

完整 MCP：网页版 ChatGPT Business、Enterprise 或 Edu · Pro：以读取/获取权限连接，修改数据的工具可能用不了 · Plus：官方文档尚未确认，如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页

在网页版 ChatGPT 打开添加 MCP 的页面
Plugins+Add custom MCP server
已完成
填写名称和地址
输入名称，在 Connection 下粘贴地址，勾选风险提示，然后点击 Create as a plugin
Name · 名称Chatroost — unofficial Telegram MCP server
Connection · 地址https://mcp.mcp-telegram.com/mcp
已完成
在聊天中选择 Chatroost — unofficial Telegram MCP server
开启新聊天，输入前先从插件列表中选择 Chatroost — unofficial Telegram MCP server
已完成
试一试
用 Chatroost — unofficial Telegram MCP server 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 ChatGPT 说正在使用 Chatroost — unofficial Telegram MCP server，或回答中出现 Chatroost — unofficial Telegram MCP server 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Claude Code · 约 2 分钟

不需要密钥，不用安装程序

打开终端
Mac：按 Command+空格，输入 Terminal · Windows：打开 PowerShell
已完成

粘贴这条命令并按 Enter

claude mcp add --transport http --scope user telegram https://mcp.mcp-telegram.com/mcp

已完成

在 Claude Code 中输入 /mcp
应能看到 Chatroost — unofficial Telegram MCP server 在列表中并显示已连接
已完成
试一试
用 Chatroost — unofficial Telegram MCP server 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 Claude Code 说正在使用 Chatroost — unofficial Telegram MCP server，或回答中出现 Chatroost — unofficial Telegram MCP server 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 2 分钟

不需要密钥，不用安装程序

点击这个按钮打开 Cursor
在 Cursor 中打开
Cursor 会请你确认安装，点击 Install
已完成
在 Cursor 中以 Agent 模式打开 AI 聊天
已完成
试一试
用 Chatroost — unofficial Telegram MCP server 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 Cursor 说正在使用 Chatroost — unofficial Telegram MCP server，或回答中出现 Chatroost — unofficial Telegram MCP server 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code · 约 2 分钟

不需要密钥，不用安装程序

点击这个按钮打开 VS Code
在 VS Code 中打开
VS Code 会请你确认安装，点击 Install
已完成
在 VS Code 中以 Agent 模式打开 AI 聊天
已完成
试一试
用 Chatroost — unofficial Telegram MCP server 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 VS Code 说正在使用 Chatroost — unofficial Telegram MCP server，或回答中出现 Chatroost — unofficial Telegram MCP server 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用（如 Windsurf、Zed、Gemini CLI）添加方式各不相同，请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

地址https://mcp.mcp-telegram.com/mcp

JSON 设置在下方“开发者专用”中

卡住了？问问正在用 Chatroost — unofficial Telegram MCP server 的人💬 讨论 →

开发者专用：终端命令和 JSON 设置

通过网页连接

Claude Code

claude mcp add --transport http --scope user telegram https://mcp.mcp-telegram.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "telegram": {
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "telegram": {
      "type": "http",
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

安装在电脑上

Claude Code

claude mcp add --scope user telegram --env TELEGRAM_API_ID=your-value --env TELEGRAM_API_HASH=your-value -- npx -y @overpod/mcp-telegram

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "your-value",
        "TELEGRAM_API_HASH": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "your-value",
        "TELEGRAM_API_HASH": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "telegram": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "your-value",
        "TELEGRAM_API_HASH": "your-value"
      }
    }
  }
}

需要你填写的值

TELEGRAM_API_ID 机密必填 env
来自 https://my.telegram.org/apps 的 Telegram API ID
查看英文原文
Telegram API ID from https://my.telegram.org/apps
TELEGRAM_API_HASH 机密必填 env
来自 https://my.telegram.org/apps 的 Telegram API hash。
查看英文原文
Telegram API hash from https://my.telegram.org/apps

说明为自动翻译，变量名保持原样；不确定时请查看原文。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

一览

GitHub 星标 i: 69
每周下载量i: 1,432/周
许可证 i: MIT
连接方式: 电脑或云端
传输方式: stdio, streamable-http
最新版本i: 1.45.1
分类i: 聊天与邮件
发布到注册中心i: 2026年11月2日
代码最后更新i: 2026年11月13日
作者: mcp-telegram
软件包: npm: @overpod/mcp-telegram
仓库: mcp-telegram/mcp-telegram
网站: mcp-telegram.com
注册状态: 活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档，检查于 2026年11月10日。

通过互联网连接，适用于

Claude ChatGPT Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Open WebUI Raycast

在你的电脑上运行，适用于

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

全部应用及其优缺点 →

它能做什么

服务器要求先登录，才会列出它的工具。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月15日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 mcp-telegram 验证，该账户拥有此仓库
✓ 通过
仍在维护
代码最后更新于前天
✓ 通过
有许可证
使用 MIT
✓ 通过
端点有响应
在 598 毫秒内响应（HTTP 401）
✓ 通过
使用 OAuth 登录
声明支持 OAuth 登录，你的 AI 应用可以带你去登录
… 尚未检查
工具描述中没有隐藏指令
尚未检查；我们会在检查端点时读取工具列表

已公开的漏洞（OSV.dev）

OSV.dev 中没有 @overpod/mcp-telegram@1.45.1 的记录

只检查这个版本的包本身，不包括所有依赖 · 检查于 2026年11月15日

我们检查什么 → · JSON

作者：申请重新检查或报告信息错误

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子，欢迎第一个提问或分享。

此处内容由用户撰写，不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“聊天与邮件”中的其他服务器比较i

星标数多于此分类中其他 2056 个服务器的 98%
发布到注册中心的时间比此分类中其他 2056 个服务器的 68% 更新
基础检查结果等于或优于此分类中其他 2056 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Chatroost — unofficial Telegram MCP server 安全吗？

它在 5 项适用的基础检查中通过了 5 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：TELEGRAM_API_ID, TELEGRAM_API_HASH

它在我的电脑上运行还是在云端？

两种方式都可以：安装在你的电脑上，或者连接云端版本。

它还在维护吗？

GitHub 仓库最后更新于前天，最新版本（1.45.1）于13天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接，因此也能用于接受远程 MCP 的应用，例如网页版 ChatGPT（Business 及以上为完整 MCP；Pro 为只读）。

有什么可以替代它？

同一分类中有：draw.io, Vexa, emailmd, Kite Discord Bot Builder, e2a — email for AI agents

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面，再按星标排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

作者：jgraph广泛使用★ 58265天前更新

在云端运行✓ 服务方 · draw.ioPopNx 团队已实际试用

接入方法

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

作者：Vexa-ai广泛使用★ 29812个月前更新

在云端运行✓ 服务方 · vexa.ai

接入方法

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

作者：anypost广泛使用↓ 5432/周★ 1391昨天更新

电脑或云端✓ 服务方 · emailmd.dev

安装

Kite Discord Bot Builder

Build and fix Discord bots from a chat. Kite hosts them 24/7, with no code to deploy.

作者：merlinfuchs正在增长★ 334 整个仓库的星标18天前更新

在云端运行✓ 服务方 · kite.onl

接入方法

e2a — email for AI agents

Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

作者：tokencanopy正在增长★ 199 整个仓库的星标4个月前更新

在云端运行✓ 服务方 · e2a.dev

接入方法

draw.io — 在云端运行，无需安装 · 不需要密钥
Vexa — 在云端运行，无需安装 · 需要密钥
emailmd — 云端或安装在电脑上都可以 · 不需要密钥
Kite Discord Bot Builder — 在云端运行，无需安装 · 不需要密钥
e2a — email for AI agents — 在云端运行，无需安装 · 不需要密钥

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Telegram MCP Server

[📖 Documentation](https://mcp-telegram.github.io/mcp-telegram/) · [☁️ Cloud version](https://mcp-telegram.com) — connect Telegram to Claude.ai or ChatGPT in 30 seconds with QR code, no API keys needed.

Telegram MCP Server — a Model Context Protocol server that connects AI assistants like Claude and ChatGPT to Telegram via the MTProto protocol. Unlike bots, this runs as a userbot -- it operates under your personal Telegram account using GramJS, giving full access to your chats, contacts, and message history.

Features

Comprehensive tool coverage -- the most full-featured Telegram MCP server available
MTProto protocol -- direct Telegram API access, not the limited Bot API
Userbot -- operates as your personal account, not a bot
Full-featured -- messaging, reactions, polls, scheduled messages, stickers, media, contacts, and more
Forum Topics -- list topics, read per-topic messages, send to specific topics, per-topic unread counts
Stickers -- search sticker sets, browse installed/recent stickers, send stickers to any chat
Account & profile management -- update profile, set emoji status, birthday, personal channel, profile photo, manage privacy settings, sessions, auto-delete timers
Chat folders -- create, edit, delete and reorder folders, toggle folder tags, read suggested folders (v1.33.0)
Global privacy -- read and set account-wide privacy settings (v1.33.0)
Global search -- search messages across all chats at once
Real-time polling -- fetch updates via stateless cursors; agent owns {pts, qts, date} state
Inline bots & buttons -- query inline bots, send results, press callback buttons
Stories -- read stories from peers, get story view stats; publish/edit/delete stories, react, pin, stealth mode, archive, report (v1.30.0)
Discussion -- get discussion-group info for channel posts with comments, list groups eligible for discussion (v1.30.0)
Read Receipts -- who read a message in a small group, when your private message was read (v1.30.0)
Admin controls -- toggle channel signatures, anti-spam, forum mode, prehistory; approve join requests
Stats -- channel and supergroup analytics (GetBroadcastStats / GetMegagroupStats)
Boosts & Business -- boost status, boosters list, Telegram Business chat links CRUD, work hours, location, greeting/away/intro messages
Star gifts -- browse available and saved gifts, save/convert gifts, manage Stars balance and subscriptions (opt-in via MCP_TELEGRAM_ENABLE_STARS=1, v1.34.0)
Shared daemon -- one background process serves multiple MCP clients over a single Telegram session; see the shared-daemon guide (v1.38.0)
QR code login -- authenticate by scanning a QR code in the Telegram app
Session persistence -- login once, stay connected across restarts
Human-readable output -- sender names are resolved, not just numeric IDs
Works with any MCP client -- Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code, Mastra, etc.

Prerequisites

Node.js 18 or later
Telegram API credentials -- API_ID and API_HASH from my.telegram.org

Quick Start

1. Get Telegram API credentials

Go to my.telegram.org and log in with your phone number.
Navigate to API development tools.
Create a new application (any name and platform).
Copy the App api_id and App api_hash.

2. Login

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH npx @overpod/mcp-telegram login

A QR code will appear in the terminal. Open Telegram on your phone, go to Settings > Devices > Link Desktop Device, and scan the code. The session is saved to ~/.mcp-telegram/session and reused automatically.

Custom session path: set TELEGRAM_SESSION_PATH=/path/to/session to store the session file elsewhere.

Two-step verification (2FA): if your account has a cloud password enabled, scanning the QR code is not enough — Telegram also requires the password. Provide it via TELEGRAM_2FA_PASSWORD so the login can complete:

`bash

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH TELEGRAM_2FA_PASSWORD=YOUR_PASSWORD npx @overpod/mcp-telegram login

`

The password is only used locally to answer Telegram's SRP challenge and is never persisted.

Local files: tools that upload a file (telegram-send-file, telegram-send-voice, telegram-send-album, stories, profile and group photos) read files under your home folder and temp folders, and downloads are saved to Downloads, Desktop, Documents or temp folders. Hidden files and folders (~/.ssh, ~/.mcp-telegram, ...), ~/Library, ~/AppData and the session file are always refused, and an existing file is never overwritten (name (1).ext is used). To use other folders, list them in MCP_TELEGRAM_FILE_DIRS (separated by :, or ; on Windows); this replaces the defaults.

3. Add to Claude

claude mcp add telegram -s user \

-e TELEGRAM_API_ID=YOUR_ID \ -e TELEGRAM_API_HASH=YOUR_HASH \ -- npx @overpod/mcp-telegram

That's it! Ask Claude to run telegram-status to verify.

Multiple Accounts

Use TELEGRAM_SESSION_PATH to run separate Telegram accounts side by side:

# Login each account with a unique session path

TELEGRAM_API_ID=ID1 TELEGRAM_API_HASH=HASH1 TELEGRAM_SESSION_PATH=~/.mcp-telegram/session-work npx @overpod/mcp-telegram login TELEGRAM_API_ID=ID2 TELEGRAM_API_HASH=HASH2 TELEGRAM_SESSION_PATH=~/.mcp-telegram/session-personal npx @overpod/mcp-telegram login

Then add each as a separate MCP server:

claude mcp add telegram-work -s user \

-e TELEGRAM_API_ID=ID1 \ -e TELEGRAM_API_HASH=HASH1 \ -e TELEGRAM_SESSION_PATH=~/.mcp-telegram/session-work \ -- npx @overpod/mcp-telegram

claude mcp add telegram-personal -s user \ -e TELEGRAM_API_ID=ID2 \ -e TELEGRAM_API_HASH=HASH2 \ -e TELEGRAM_SESSION_PATH=~/.mcp-telegram/session-personal \ -- npx @overpod/mcp-telegram

Each account gets its own session file — no conflicts.

Multiple agents / concurrent clients (shared daemon)

The opposite of multiple accounts: one account driven by many clients at once — several Claude Code windows, parallel sub-agents, or multiple IDEs. Normally each process opens the same session and they evict one another with AUTH_KEY_DUPLICATED. Serve mode fixes this.

Run a single persistent daemon that owns the one Telegram connection. Every other process auto-detects the daemon (via a PID lock) and becomes a thin client that proxies tool calls to it over a local Unix socket:

# On the host, once: start the daemon (owns the connection, no stdio)

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH mcp-telegram serve

(or set MCP_TELEGRAM_DAEMON=1 instead of the `serve` argument)

Then point each MCP client at the same install with the same TELEGRAM_SESSION_PATH — no serve argument. They connect to the daemon automatically; closing any client never drops the shared connection. Credentials are only required by the daemon (the owner), so client commands can omit TELEGRAM_API_ID/TELEGRAM_API_HASH and keep them where the daemon runs.

See the [shared daemon guide](docs/guides/shared-daemon.md) for a systemd unit and SSH usage.

Proxy Support

If Telegram is blocked or you're running in a containerized environment (Docker, K3s), use a SOCKS5 or MTProxy:

# SOCKS5 proxy

TELEGRAM_PROXY_IP=127.0.0.1 \ TELEGRAM_PROXY_PORT=10808 \ npx @overpod/mcp-telegram

MTProxy

TELEGRAM_PROXY_IP=proxy.example.com \ TELEGRAM_PROXY_PORT=443 \ TELEGRAM_PROXY_SECRET=ee00000000000000000000000000000000 \ npx @overpod/mcp-telegram

Variable	Description
`TELEGRAM_PROXY_IP`	Proxy server address
`TELEGRAM_PROXY_PORT`	Proxy server port
`TELEGRAM_PROXY_SOCKS_TYPE`	`4` or `5` (default: `5`)
`TELEGRAM_PROXY_SECRET`	MTProxy secret (enables MTProxy mode)
`TELEGRAM_PROXY_USERNAME`	Optional proxy auth
`TELEGRAM_PROXY_PASSWORD`	Optional proxy auth

Connecting via WSS (port 443)

If your VPS or hosting IP is reachable on outbound port 443 but not the default MTProto port 80 (some cloud providers ban port 80 on Telegram DC IP ranges as anti-abuse policy), set:

TELEGRAM_USE_WSS=true npx @overpod/mcp-telegram

Variable	Description
`TELEGRAM_USE_WSS`	When `true`, gramJS uses port `443` instead of `80` for the MTProto TCPFull transport. Default: `false`. Cannot be combined with `TELEGRAM_PROXY_*` (gramJS limitation) — if both are set, `useWSS` is ignored and the proxy takes precedence (a warning is logged).

Installation Options

npx (recommended, zero install)

No need to clone or install anything. Just use npx @overpod/mcp-telegram.

Global install

npm install -g @overpod/mcp-telegram

mcp-telegram # run server mcp-telegram login # QR login

Pre-built binary (no runtime needed)

Download from Releases — standalone single-file binaries, zero dependencies:

Platform	Server	Login CLI
Linux x64	`mcp-telegram-linux-x64`	`mcp-telegram-login-linux-x64`
Linux ARM64	`mcp-telegram-linux-arm64`	`mcp-telegram-login-linux-arm64`
macOS x64	`mcp-telegram-darwin-x64`	`mcp-telegram-login-darwin-x64`
macOS ARM64	`mcp-telegram-darwin-arm64`	`mcp-telegram-login-darwin-arm64`
Windows x64	`mcp-telegram-windows-x64.exe`	`mcp-telegram-login-windows-x64.exe`

# Download (example for Linux x64)

curl -L -o mcp-telegram https://github.com/mcp-telegram/mcp-telegram/releases/latest/download/mcp-telegram-linux-x64 curl -L -o mcp-telegram-login https://github.com/mcp-telegram/mcp-telegram/releases/latest/download/mcp-telegram-login-linux-x64 chmod +x mcp-telegram mcp-telegram-login

Login

TELEGRAM_API_ID=YOUR_ID TELEGRAM_API_HASH=YOUR_HASH ./mcp-telegram-login

Run

./mcp-telegram

From source

git clone https://github.com/mcp-telegram/mcp-telegram.git

cd mcp-telegram npm install && npm run build

Docker

docker build -t mcp-telegram https://github.com/mcp-telegram/mcp-telegram.git

docker run -it --rm \

-e TELEGRAM_API_ID=YOUR_ID \ -e TELEGRAM_API_HASH=YOUR_HASH \ -v ~/.mcp-telegram:/root/.mcp-telegram \ --entrypoint node mcp-telegram dist/qr-login-cli.js

Run the MCP server:

docker run -i --rm \

-e TELEGRAM_API_ID=YOUR_ID \ -e TELEGRAM_API_HASH=YOUR_HASH \ -v ~/.mcp-telegram:/root/.mcp-telegram \ mcp-telegram

Note: Login must be done once via terminal. After that, the session is persisted in ~/.mcp-telegram and reused a

只显示了开头部分；其余内容请在仓库中阅读

Chatroost — unofficial Telegram MCP server

What it does

安装

打开 Claude 的 Connectors 页面

点击“Add” → “Custom” → “Web”，填写这 2 项

在聊天中开启

试一试

在网页版 ChatGPT 打开添加 MCP 的页面

填写名称和地址

在聊天中选择 Chatroost — unofficial Telegram MCP server

试一试

打开终端

粘贴这条命令并按 Enter

在 Claude Code 中输入 /mcp

试一试

点击这个按钮打开 Cursor

在 Cursor 中以 Agent 模式打开 AI 聊天

试一试

点击这个按钮打开 VS Code

在 VS Code 中以 Agent 模式打开 AI 聊天

试一试

通过网页连接

安装在电脑上

需要你填写的值

一览

哪些应用可以使用它

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

已公开的漏洞（OSV.dev）

讨论

用户评价

与“聊天与邮件”中的其他服务器比较i

常见问题

功能相近的其他选择

draw.io

Vexa

emailmd

Kite Discord Bot Builder

e2a — email for AI agents

作者的 README

Telegram MCP Server

Features

Prerequisites

Quick Start

1. Get Telegram API credentials

2. Login

3. Add to Claude

Multiple Accounts

Multiple agents / concurrent clients (shared daemon)

(or set MCP_TELEGRAM_DAEMON=1 instead of the serve argument)

Proxy Support

MTProxy

Connecting via WSS (port 443)

Installation Options

npx (recommended, zero install)

Global install

Pre-built binary (no runtime needed)

Login

Run

From source

Docker

(or set MCP_TELEGRAM_DAEMON=1 instead of the `serve` argument)