mcpbeat Sign in

Better Telegram MCP Server

local only

Better Telegram MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 2 385 installs a week from pypi. Last commit 13 Sep 2026.

Telegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.

The author archived this repository on GitHub, meaning it is no longer maintained.

Installs per day peak 1 290 · avg 335 · -12% w/w
a month agotoday
2 385
Installs / week
pypi · better-telegram-mcp
11
Stars
1 open issues
13 Sep 2026
Last commit
0 releases in 90 days
Apache-2.0
License
Python

What the code does

We read the source, 23 h ago · rules 3dff92dd89df

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.

API_BASE = "https://api.telegram.org/bot{}/"

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-telegram-mcp -- uvx better-telegram-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "better-telegram-mcp": {
      "args": [
        "better-telegram-mcp"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.better-telegram-mcp]
command = "uvx"
args = ["better-telegram-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "better-telegram-mcp": {
      "args": [
        "better-telegram-mcp"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "better-telegram-mcp": {
      "args": [
        "better-telegram-mcp"
      ],
      "command": "uvx"
    }
  }
}

This one needs environment variables set before it will start: TELEGRAM_BOT_TOKEN (Telegram bot token from @BotFather (for bot mode)), TELEGRAM_API_ID (Telegram API ID from my.telegram.org (for user mode)), TELEGRAM_API_HASH (Telegram API hash from my.telegram.org (for user mode)). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Better Telegram MCP

same job, measured the same way
Wazap
by razvangirgiz

WhatsApp for your agent: chats, messages, media, contacts and groups behind MCP tools.

1 949 installs/wk local only
Telegram MCP
by jgalea

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

90 installs/wk local only
Telegram Archive MCP
by geiserx

MCP server for Telegram Archive — search messages, browse chats, and access history

47 installs/wk local only
Claude Ops Telegram Server
by auroracapital

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

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

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

local only
Dialogbrain
by saloprj

Unified inbox MCP for WhatsApp, Telegram, Email, voice — read/send messages, search, AI agents.

answering
MCP Z API
by codespar

MCP server for Z-API — WhatsApp messaging, contacts, media

24 installs/wk local only
ManyContacts - WhatsApp Business MCP
by manycontacts

WhatsApp Business MCP: send messages, manage contacts, campaigns, and AI agents.

66 installs/wk local only

Better Telegram MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Better Telegram MCP?
Better Telegram MCP 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 pypi package better-telegram-mcp was installed 2 385 times last week.
Is Better Telegram MCP still maintained?
The author archived this repository on GitHub, meaning it is no longer maintained. We show this because it changes what you can expect: an unmaintained server may keep answering for months and then stop without warning.
How do I connect Better Telegram MCP?
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-telegram-mcp straight from pypi; nothing to host, nothing to sign up for.
How many people use Better Telegram MCP?
The pypi package better-telegram-mcp was installed 2 385 times in the last week. Week over week that is -12%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Better Telegram MCP open source?
Yes — it is published under the Apache-2.0 licence, written in Python, 11 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.