Claude Ops Telegram Server runs on your own machine — the client starts it, so there is no endpoint to ping. 74 installs a week from npm. Last commit 2 Nov 2026.
Telegram personal-account MCP (MTProto user-auth). Read DMs, send messages, search across chats.
What the code does
We read the source, 5 h ago · rules 995398eba69f
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
const TG_BASE = `https://api.telegram.org/bot${BOT_TOKEN}`;
Found in continuous integration, deployment or infrastructure files, or in a neighbouring package of the same monorepo. None of this is installed when you add the server: it describes how the project is built and released. We list it because a leaked key in a build pipeline is still a real problem, but it is not something this server does on your machine.
const result = spawnSync(bin, args, { encoding: 'utf8', env });
return subprocess.run(
shell=True,
const from = path.join(srcDir, "bin", name);
RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add claude-ops-telegram-server -e 'TELEGRAM_API_ID=<TELEGRAM_API_ID>' -e 'TELEGRAM_API_HASH=<TELEGRAM_API_HASH>' -e 'TELEGRAM_PHONE=<TELEGRAM_PHONE>' -e 'TELEGRAM_SESSION=<TELEGRAM_SESSION>' -- npx -y claude-ops-telegram-server{
"mcpServers": {
"claude-ops-telegram-server": {
"command": "npx",
"args": [
"-y",
"claude-ops-telegram-server"
],
"env": {
"TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>",
"TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
"TELEGRAM_PHONE": "<TELEGRAM_PHONE>",
"TELEGRAM_SESSION": "<TELEGRAM_SESSION>"
}
}
}
}[mcp_servers.claude-ops-telegram-server]
command = "npx"
args = ["-y", "claude-ops-telegram-server"]
env = { TELEGRAM_API_ID = "<TELEGRAM_API_ID>", TELEGRAM_API_HASH = "<TELEGRAM_API_HASH>", TELEGRAM_PHONE = "<TELEGRAM_PHONE>", TELEGRAM_SESSION = "<TELEGRAM_SESSION>" }{
"mcpServers": {
"claude-ops-telegram-server": {
"command": "npx",
"args": [
"-y",
"claude-ops-telegram-server"
],
"env": {
"TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>",
"TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
"TELEGRAM_PHONE": "<TELEGRAM_PHONE>",
"TELEGRAM_SESSION": "<TELEGRAM_SESSION>"
}
}
}
}{
"servers": {
"claude-ops-telegram-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"claude-ops-telegram-server"
],
"env": {
"TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>",
"TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
"TELEGRAM_PHONE": "<TELEGRAM_PHONE>",
"TELEGRAM_SESSION": "<TELEGRAM_SESSION>"
}
}
}
}Put your own values in place of
<TELEGRAM_API_ID> (Numeric API ID from https://my.telegram.org/apps (create a personal app, not a bot)), <TELEGRAM_API_HASH> (API hash from the same my.telegram.org/apps page), <TELEGRAM_PHONE> (Your Telegram phone number in E.164 format (e.g. +14155551234)), <TELEGRAM_SESSION> (gram.js StringSession token. Generate once via: node index.js --auth (prompts for SMS code + optional 2FA). Store in your secret manager — never commit).
The author’s registry entry marks them as required.
Alternatives to Claude Ops Telegram Server
same job, measured the same wayTelegram MCP server: read, send, and search messages and manage chats via your account.
Search and read your archived Telegram chats and messages
Read a personal Telegram account over MTProto; every write is a plan a human applies.
Read chats and members; send, edit and delete messages with a bot in Telegram.
Telegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.
Unofficial Telegram MCP server — read, search, reply and react in your own Telegram account.
Your Telegram account for agents: read, search and send messages. Sign in with the tg CLI first.
AI-native Microsoft Teams integration — read chats, send messages, search people
Claude Ops Telegram Server — questions
Answers built from our own checks of this server.