Is Better Telegram free?

Yes, Better Telegram is free to use.

How do I install Better Telegram?

Better Telegram is a local plugin. Install it using PyPI package: better-telegram-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Better Telegram need?

Better Telegram requires the following credentials or environment variables: TELEGRAM_BOT_TOKEN, TELEGRAM_API_ID, TELEGRAM_API_HASH. You can find setup instructions on the server detail page.

What AI apps work with Better Telegram?

Better Telegram uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Better Telegram MCP Server

by N24q02m

CommunicationLow Risk10.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

Telegram MCP server — dual-mode Bot API + MTProto, 6 composite tools.

About

Telegram MCP server — dual-mode Bot API + MTProto, 6 composite tools.

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (11/12 approved).

4 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Telegram bot token from @BotFather (for bot mode)Required

Environment variable: TELEGRAM_BOT_TOKEN

Telegram API ID from my.telegram.org (for user mode)Optional

Environment variable: TELEGRAM_API_ID

Telegram API hash from my.telegram.org (for user mode)Required

Environment variable: TELEGRAM_API_HASH

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-n24q02m-better-telegram-mcp": {
      "env": {
        "TELEGRAM_API_ID": "your-telegram-api-id-here",
        "TELEGRAM_API_HASH": "your-telegram-api-hash-here",
        "TELEGRAM_BOT_TOKEN": "your-telegram-bot-token-here"
      },
      "args": [
        "better-telegram-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Better Telegram MCP

mcp-name: io.github.n24q02m/better-telegram-mcp

MCP server for Telegram with dual-mode support: Bot API (httpx) for quick bot integrations and MTProto (Telethon) for full user-account access.

Features

Dual mode -- Bot API (httpx) for bots, MTProto (Telethon) for user accounts
6 tools with action dispatch: message, chat, media, contact, config, help
Auto-detect mode -- Set bot token for bot mode, or API credentials for user mode
Web-based OTP auth -- Browser-based authentication with remote relay support for headless environments
Tool annotations -- Each tool declares readOnlyHint, destructiveHint, idempotentHint, openWorldHint
MCP Resources -- Documentation available as telegram://docs/* resources
Security hardened -- SSRF protection, path traversal prevention, error sanitization

Setup

With AI Agent -- copy and send this to your AI agent:

Please set up better-telegram-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-telegram-mcp/main/docs/setup-with-agent.md

Manual Setup -- follow docs/setup-manual.md

Tools

Tool	Actions	Description
`message`	`send`, `edit`, `delete`, `forward`, `pin`, `react`, `search`, `history`	Send, edit, delete, forward messages. Pin, react, search, browse history
`chat`	`list`, `info`, `create`, `join`, `leave`, `members`, `admin`, `settings`, `topics`	List and manage chats, groups, channels. Members, admin, forum topics
`media`	`send_photo`, `send_file`, `send_voice`, `send_video`, `download`	Send photos, files, voice notes, videos. Download media from messages
`contact`	`list`, `search`, `add`, `block`	List, search, add contacts. Block/unblock users (user mode only)
`config`	`status`, `set`, `cache_clear`, `setup_status`, `setup_start`, `setup_reset`, `setup_complete`	Server status, runtime settings, cache, credential setup (relay, status, reset, complete)
`help`	--	Full documentation for any topic

MCP Resources

URI	Content
`telegram://docs/messages`	Message operations reference
`telegram://docs/chats`	Chat management reference
`telegram://docs/media`	Media send/download reference
`telegram://docs/contacts`	Contact management reference
`telegram://stats`	All documentation combined

Security

SSRF Protection -- All URLs validated against internal/private IP ranges, DNS rebinding blocked
Path Traversal Prevention -- File paths validated, sensitive directories blocked
Session File Security -- 600 permissions, 2FA via web UI only (never stored in env vars)
Error Sanitization -- Credentials never leaked in error messages

Build from Source

git clone https://github.com/n24q02m/better-telegram-mcp.git
cd better-telegram-mcp
uv sync
uv run better-telegram-mcp

License

MIT -- See LICENSE.

Reviews

No reviews yet

Be the first to review this server!

More Communication MCP Servers

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

mcp-creator-typescript

Free

by mcp-marketplace · Developer Tools

Scaffold, build, and publish TypeScript MCP servers to npm — conversationally

FinAgent

Free

by mcp-marketplace · Finance

Free stock data and market news for any MCP-compatible AI assistant.

Google Workspace MCP

Free

by Taylorwilsdon · Productivity

Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI

Better Telegram MCP Server

About

Security Report