mcpbeat Sign in

mcp-telegram-agent MCP Server

by a19901201 Your server? Claim it
local only

mcp-telegram-agent runs on your own machine — the client starts it, so there is no endpoint to ping. 3 005 installs a week from pypi. Last commit 5 Nov 2026.

Full Telegram Bot control for AI agents via pure Bot API: zero login risk, one Bot Token.

Installs per day peak 1 612 · avg 100
a month agotoday
3 005
Installs / week
pypi · mcp-telegram-agent
3
Stars
0 open issues
5 Nov 2026
Last commit
from GitHub
MIT
License
Python

What the code does

We read the source, 20 h ago · rules 995398eba69f

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.

    url = f"https://api.telegram.org/bot{BOT_TOKEN}/{endpoint}"

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

Alternatives to mcp-telegram-agent

same job, measured the same way
Telegram MCP
by n24q02m

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

124 installs/wk local only
Hail
by hail-hq

Phone, SMS and email for AI agents. One remote MCP endpoint, OAuth login, zero install.

40 tools answering
Discord Node MCP
by oratorian

MCP server for controlling Discord servers via bot token

87 installs/wk local only
Oracle H
by tponscr-debug

Human approval gate for AI agents. Critical actions approved or rejected by a human via Telegram.

45 installs/wk local only
Telethon Plus
by psyb0t

Self-hosted MCP server: Telegram userbot control (Telethon) via HTTP and MCP.

local only
Telemost MCP Server
by telemost

Telegram channel analytics and statistics for AI agents, pay-per-call in USDC via x402.

64 installs/wk 20 tools answering
Veynod
by veynod

Shared blackboard and MCP control plane for multi-agent teams.

answering
Agent Blueprint
by agent-blueprint

Client teams' blueprints for coding agents (token from an engagement). Free: agentblueprint.ai/mcp

291 installs/wk local only

mcp-telegram-agent — questions

Answers built from our own checks of this server.

Why is there no uptime for mcp-telegram-agent?
mcp-telegram-agent 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 mcp-telegram-agent was installed 3 005 times last week.
How do I connect mcp-telegram-agent?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls mcp-telegram-agent straight from pypi; nothing to host, nothing to sign up for.
How many people use mcp-telegram-agent?
The pypi package mcp-telegram-agent was installed 3 005 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is mcp-telegram-agent open source?
Yes — it is published under the MIT licence, written in Python and 3 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.