mcp-telegram

by beautyfree · Productivity · ★ 32

mcp-telegram is an MCP server by beautyfree. Telegram MCP server (MTProto). Connect Claude, Cursor, Claude Code, VS Code, Codex, Cline, Windsurf to a real Telegram account — read/search/send messages, moderate channels, manage stories/contacts/folders, transcribe voice, and call any raw MTProto method. Browser-based sign-in. 100+ tools. It has 32 GitHub stars and ranks #473 of 1809 in Productivity by stars.

Category: Productivity
Author: beautyfree
GitHub stars: 32
This week: Tracking since 18 Oct 2026
Weekly downloads: 92
Language: TypeScript
License: MIT (open source)
Last update: 2026-05-18 (5 months ago)
Links: Source Website npm

ai-agent
ai-tools
claude
claude-code
claude-desktop
cursor
gramjs
llm-tools
mcp
mcp-server
mcp-telegram
model-context-protocol
+8 more

How to install mcp-telegram

mcp-telegram is published on npm as mcp-telegram, and it depends on @modelcontextprotocol/sdk. These steps assume it runs as a local stdio server, which is the usual setup.

Check the README. Confirm the start command and note any API keys or environment variables it needs (pass them with -e KEY=value or an env block). You need Node.js for npx.

Add it to Claude Code from a terminal:

claude mcp add mcp-telegram -- npx -y mcp-telegram

Or add it to Cursor or Claude Desktop in .cursor/mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-telegram"
      ]
    }
  }
}

Restart the client and check it. Run claude mcp list, or open the client's MCP settings, and confirm mcp-telegram and its tools are listed. The install guide covers VS Code and Codex.

Also listed in

Maintain this project? Get it featured ($99/mo, pinned at the top of Productivity) or see what featuring includes.

Report a problem with this listing

Frequently asked questions

What is mcp-telegram?

mcp-telegram is an MCP server by beautyfree in the Productivity category. Telegram MCP server (MTProto). Connect Claude, Cursor, Claude Code, VS Code, Codex, Cline, Windsurf to a real Telegram account — read/search/send messages, moderate channels, manage stories/contacts/folders, transcribe voice, and call any raw MTProto method. Browser-based sign-in. 100+ tools. It has 32 GitHub stars and ranks #473 of 1809 in Productivity by stars.

Is mcp-telegram free and open source?

Yes. mcp-telegram is published under the MIT license, so you can run, modify and self-host it at no cost. If it connects to a paid service, that service's own pricing and API terms still apply. Check the repository for the exact license text before using it commercially.

What are the alternatives to mcp-telegram?

Other Productivity projects on MCP Harbor include markitdown, Agent-Reach, AstrBot. Each alternative links to its own page with stars, license and recent activity. The Productivity category ranks all 1809 by stars, and you can re-sort it by growth this week.

Alternatives to mcp-telegram

markitdown★ 191,862

microsoft · Python

Python tool for converting files and office documents to Markdown.

Agent-ReachTrending★ 101,437

Panniantong · Python+2,844 stars this week (+2.9%)

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

AstrBotTrending★ 43,082

AstrBotDevs · Python+1,030 stars this week (+2.4%)

AI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨

CopilotKit★ 38,201

CopilotKit · TypeScript

The Frontend Stack for Agents & Generative UI. React, Angular, Mobile, Slack, and more. Makers of the AG-UI Protocol

activepieces★ 25,196

activepieces · TypeScript+114 stars this week (+0.5%)

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

n8n-mcp★ 23,126

czlonkowski · TypeScript+32 stars this week (+0.1%)

A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you

All 1809 Productivity MCP servers →

Data last updated 25 October 2026. Stars and downloads are refreshed every day from GitHub and npm.