mcpbeat Sign in

Better-TG-CLI (Telegram) MCP Server

by thevilfer Your server? Claim it
local only

Better-TG-CLI (Telegram) runs on your own machine — the client starts it, so there is no endpoint to ping. 262 installs a week from npm. Last commit 10 Oct 2026.

Telegram on your own account: read, search, send and press bot buttons. Writes need your approval.

Installs per day peak 1 889 · avg 139 · +22% w/w
a month agotoday
262
Installs / week
npm · better-tg-cli
2
Stars
6 open issues
10 Oct 2026
Last commit
30 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 2 h ago · rules ccca72095570

Capabilities

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.

A line of code looks encrypted broker/src/assets.ts:6
  "iVBORw0KGgoAAAANSUhEUgAABQAAAAKACAIAAABMkUL2AAAQAElEQVR4nOzdCbhd4/kw/CWCmGKoKcRMRaih5qnmeSrqX1U1vWiooVozRQeqKFUtQVVbSkupocbEFDFPMQVREYkhIvmbEpSQ7/72ut71ru69z8k5Z5+ck32e3+/KlWvtde6zh7XXWue5n3s9z+qVAQAAQAJ6ZQAAAJAACTAAAABJkAADAACQBAkwAAAASeidAQDM9GaZZZb4f9q0aSJFihQpUmSHI1WAAQAAS…
    spawn(cmd, args, { stdio: 'ignore', detached: true, windowsHide: true }).on('error', () => {}).unref();
Long encoded blob in source broker/src/assets.ts:6
  "iVBORw0KGgoAAAANSUhEUgAABQAAAAKACAIAAABMkUL2AAAQAElEQVR4nOzdCbhd4/kw/CWCmGKoKcRMRaih5qnmeSrqX1U1vWiooVozRQeqKFUtQVVbSkupocbEFDFPMQVREYkhIvmbEpSQ7/72ut71ru69z8k5Z5+ck32e3+/KlWvtde6zh7XXWue5n3s9z+qVAQAAQAJ6ZQAAAJAACTAAAABJkAADAACQBAkwAAAASeidAQDM9GaZZZb4f9q0aSJFihQpUmSHI1WAAQAAS…

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.

Three servers free · no card

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.

run in your terminal
claude mcp add better-tg-cli -- npx -y better-tg-cli
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "better-tg-cli": {
      "args": [
        "-y",
        "better-tg-cli"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.better-tg-cli]
command = "npx"
args = ["-y", "better-tg-cli"]
.cursor/mcp.json
{
  "mcpServers": {
    "better-tg-cli": {
      "args": [
        "-y",
        "better-tg-cli"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "better-tg-cli": {
      "args": [
        "-y",
        "better-tg-cli"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: TG_PROFILE (Optional profile name, to keep this client on a separate Telegram session). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Better-TG-CLI (Telegram)

same job, measured the same way
Telegram MCP
by jgalea

Telegram MCP server: read, send, and search messages and manage chats via your account.

466 installs/wk local only
Chatroost — unofficial Telegram MCP server
by mcp-telegram

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

1 588 installs/wk answering
Claude Ops Telegram Server
by auroracapital

Telegram personal-account MCP (MTProto user-auth). Read DMs, send messages, search across chats.

39 installs/wk local only
T
Telegram AI CLI MCP
by stufently

Read a personal Telegram account over MTProto; every write is a plan a human applies.

local only
Whatsapp
by wacli

Your own WhatsApp as an MCP server: read, search and send from any MCP client.

answering
Slack
by aaronsb

Read and write Slack with session tokens — no OAuth, no bot, no admin approval.

422 installs/wk local only
TG multi-account MCP
by mesteriis

Self-hosted, consent-based access to Telegram accounts and bots for MCP clients

245 installs/wk local only
Google Mail MCP
by mmedum

Gmail over MCP from your own account: search, read threads and messages, labels and drafts.

local only

Better-TG-CLI (Telegram) — questions

Answers built from our own checks of this server.

Why is there no uptime for Better-TG-CLI (Telegram)?
Better-TG-CLI (Telegram) runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package better-tg-cli was installed 262 times last week.
How do I connect Better-TG-CLI (Telegram)?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls better-tg-cli straight from npm; nothing to host, nothing to sign up for.
How many people use Better-TG-CLI (Telegram)?
The npm package better-tg-cli was installed 262 times in the last week. Week over week that is +22%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Better-TG-CLI (Telegram) open source?
Yes — it is published under the MIT licence, written in TypeScript, 2 stars on GitHub and 6 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.