Chatroost — unofficial Telegram MCP server

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

제작자: mcp-telegram버전 1.45.1i★ 65i컴퓨터 또는 클라우드

레지스트리 이름io.github.mcp-telegram/mcp-telegram

설치

개요

제작자가 쓴 설명(영어 원문)

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

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i5개 중 5개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아주 새로움★ 65

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 컴퓨터 또는 클라우드
전송 방식: stdio, Streamable HTTP
카테고리: 채팅 및 이메일
입력해야 할 값: TELEGRAM_API_ID, TELEGRAM_API_HASH

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 5개 중 5개 통과
제작자의 서버에서 실행돼요. 내가 요청한 내용은 제작자의 서버를 거쳐요.
직접 입력할 값: TELEGRAM_API_ID, TELEGRAM_API_HASH

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

클라우드에서 실행설치할 것 없음. 인터넷으로 연결돼요
npmNode.js 설치(npx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

웹, 데스크톱, 모바일의 Claude에서 쓸 수 있어요:

Settings → Connectors 열기
Add custom connector 누르기
아래 주소를 붙여 넣고 Add 누르기
로그인하라고 하면 제작자의 서비스에 로그인하기

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

또는 내 컴퓨터에서 실행하기

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

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

터미널에서 이 명령어를 실행하세요

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

또는 내 컴퓨터에서 실행하기

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

실행하기 전에 빈 값을 채워 주세요.

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

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

또는 내 컴퓨터에서 실행하기

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.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에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

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

또는 내 컴퓨터에서 실행하기

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요:

웹에서 ChatGPT 열기 → Settings → Connectors (Apps)
Create 또는 Add 누르기(일부 요금제는 먼저 Advanced에서 Developer mode를 켜야 해요)
아래 주소를 붙여 넣고 이름을 정한 뒤 저장하기
로그인하라고 하면 제작자의 서비스에 로그인하기

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

메뉴 이름은 요금제나 시기에 따라 조금 다를 수 있어요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

TELEGRAM_API_ID 비밀 필수 env
Telegram API ID from https://my.telegram.org/apps
TELEGRAM_API_HASH 비밀 필수 env
Telegram API hash from https://my.telegram.org/apps

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

서버가 도구 목록을 보여 주기 전에 로그인을 요구해요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 6일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 mcp-telegram 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
✓ 통과
계속 관리되고 있음
코드 마지막 변경: 4일 전
✓ 통과
라이선스 있음
MIT 사용
✓ 통과
엔드포인트 응답
129ms 만에 응답(HTTP 401)
✓ 통과
OAuth로 로그인
OAuth 로그인을 지원한다고 밝혀서, AI 앱이 로그인 화면으로 안내해 줘요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
아직 점검하지 않았어요. 엔드포인트를 점검할 때 도구 목록을 읽어요

채팅 및 이메일 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 1766개 중 100%보다 스타가 많아요
이 카테고리의 다른 서버 1766개 중 84%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 1766개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Chatroost — unofficial Telegram MCP server, 안전한가요?

해당하는 기본 점검 5개 중 5개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: TELEGRAM_API_ID, TELEGRAM_API_HASH

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

둘 다 가능해요. 내 컴퓨터에 설치해도 되고, 클라우드 버전에 연결해도 돼요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 4일 전 변경됐고, 최신 버전(1.45.1)은 4일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되기 때문에, 원격 MCP 서버를 지원하는 앱(예: 개발자 모드의 ChatGPT)에서도 쓸 수 있어요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Vexa, emailmd, MCP WhatsApp Cloud

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Vexa

제작자: Vexa-ai

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

클라우드에서 실행★ 2,949Apache-2.02개월 전 업데이트

설치

emailmd

제작자: anypost

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

컴퓨터 또는 클라우드★ 1,385MIT31일 전 업데이트

설치

MCP WhatsApp Cloud

제작자: codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

내 컴퓨터에서 실행★ 277MIT5개월 전 업데이트

설치

제작자의 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

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

또는 내 컴퓨터에서 실행하기

또는 내 컴퓨터에서 실행하기

또는 내 컴퓨터에서 실행하기

또는 내 컴퓨터에서 실행하기

직접 입력할 값

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

채팅 및 이메일 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Vexa

emailmd

MCP WhatsApp Cloud

제작자의 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)