Communication · AI Chatbot

Telegram MCP logo

Telegram MCP

chigwell/telegram-mcp

A Telegram integration for Claude, Cursor, and other MCP-compatible clients. It exposes Telegram account, chat, message, contact, media, folder, and admin operations through the Model Context Protocol using Telethon.

Install

npx -y mcp-remote http://127.0.0.1:8765/mcp

Client configuration

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

Environment variables

TELEGRAM_API_IDTELEGRAM_API_HASHTELEGRAM_SESSION_STRINGTELEGRAM_SESSION_NAMETELEGRAM_EXPOSED_TOOLSTELEGRAM_FILE_EXTENSIONSTELEGRAM_TRANSCRIBETELEGRAM_TRANSCRIBE_ENGINEGROQ_API_KEYTELEGRAM_FLOOD_SLEEP_THRESHOLDTELEGRAM_SESSION_STRING_WORKTELEGRAM_SESSION_STRING_PERSONAL
Author
@chigwell
Category
Communication, AI Chatbot
License
Apache-2.0
Updated
Oct 6, 2026

Features

  • Accounts: list configured accounts and route tool calls by account label.

  • Chats and groups: list chats, inspect metadata, create groups/channels, join or leave chats, invite or remove users, manage admins, bans, default permissions, slow mode, topics, invite links, common…

  • Messages: send, schedule, edit, delete, forward, pin, unpin, mark read, reply, search, inspect context, create polls, manage reactions, inspect inline buttons, and press inline callbacks.…

  • Contacts: list, search, add, delete, block, unblock, import, export, inspect direct chats, find recent contact interactions, and remember contacts by the names you actually use (see below).

  • Media: send files, download media, upload files, send voice notes, stickers, GIFs, inspect message media, and transcribe voice messages/video notes (see below).

  • groq (default): uploads the recording to Groq's hosted whisper-large-v3-turbo. Leaves the server and costs a download+upload per call, but doesn't drop the recording's last few words the way native…

  • telegram: native Telegram Premium transcription (messages.TranscribeAudioRequest). Free and never leaves Telegram, but empirically drops the last speech segment in roughly 2 of 3 recordings and…

  • openai: any OpenAI-compatible /audio/transcriptions endpoint — OpenAI itself, a self-hosted Parakeet or speaches server, LocalAI, a vLLM Whisper deployment, and so on. Set…

  • whisper: a local faster-whisper model loaded inside the MCP server process. The audio never leaves the machine. Install the extra with pip install 'telegram-mcp[whisper]' (or uv sync --extra…

  • off: transcription is disabled at runtime. The transcribe_voice tool stays registered and returns {"transcribed": false, "reason": "transcription_disabled"} instead of transcribing, and listings…

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux

Related MCP servers

More servers
Inbox Zero AI MCP logo

Inbox Zero AI MCP

elie222/inbox-zero

7.1k

To help you spend less time in your inbox, so you can focus on what matters most.

Communication
whatsapp logo

whatsapp

lharries/whatsapp-mcp

3.6k

This is a Model Context Protocol (MCP) server for WhatsApp.

Communication
Apple MCP Server logo

Apple MCP Server

Dhravya/apple-mcp

1.5k

Apple MCP toolset is a collection of Apple native tools based on the MCP protocol, providing integration services for Messages, Notes, Contacts, Mail, Reminders, Calendar and other Apple ecosystem features.

Communication
supergateway logo

supergateway

supercorp-ai/supergateway

1.1k

Supergateway runs MCP stdio-based servers over SSE (Server-Sent Events) or WebSockets (WS) with one command. This is useful for remote access, debugging, or connecting to clients when your MCP server only supports stdio.

Communication
Line Bot MCP Server logo

Line Bot MCP Server

line/line-bot-mcp-server

338

Model Context Protocol (MCP) server implementation that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

Communication
MCP Send Email logo

MCP Send Email

resend/mcp-send-email

325

Connect your AI agent to the Resend platform. Send and receive emails, manage contacts, broadcasts, domains, and more, directly from any MCP client like Claude, Cursor, or Claude Code.

Communication