Communication · Developer Tools

MCP Telegram logo

MCP Telegram

tacticlaunch/mcp-telegram

A Model Context Protocol (MCP) server that connects Claude Desktop, Codex CLI, Cursor, Claude Code, VS Code, Cline, Windsurf, Goose, and any other MCP-compatible client to a real Telegram user account via MTProto—so your agent can read, search, send, moderate, and manage Telegram chats from chat or automated tool calls instead of clicking through the Telegram UI.

Install

npx -y mcp-telegram

Client configuration

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

Environment variables

TELEGRAM_API_IDTELEGRAM_API_HASH
GitHub stars
1
Category
Communication, Developer Tools
License
MIT
Updated
Oct 6, 2026

About MCP Telegram

Telegram MCP server for Claude, Codex, Cursor, Claude Code, VS Code, Cline, Windsurf, and other MCP clients. Real Telegram user account via MTProto, browser-based local sign-in, 100+ tools. Need lazy-loading + lower context cost? See telegram-agent, the skill-based companion.

Tools (40)

  • login

    Open the browser-based sign-in flow.

  • list_accounts

    List signed-in accounts.

  • list_dialogs

    List dialogs/chats/channels.

  • list_messages

    List messages in a dialog.

  • search_messages

    Search inside one dialog: query, filter (photos/videos/url/voice/...), fromUser, date range.

  • search_global

    Search across every chat you have.

  • search_dialogs

    Find dialogs by name/title/username substring.

  • send_message

    Send text.

  • send_file

    Send a file (local path or https:// URL).

  • download_media

    Save the media on a message to disk.

  • transcribe_message

    Transcribe a voice/video note (Premium).

  • invoke_mtproto

    Call any raw MTProto method by name.

  • logout

    Drop a local session and revoke it on Telegram.

  • open_settings

    Open the local settings page (tool surface + read-only).

  • get_me

    Return the profile of the authenticated user.

  • update_profile

    Change own first/last name and bio.

  • update_my_username

    Set or clear own @username.

  • set_birthday

    Set the account birthday.

  • set_profile_photo

    Upload a new avatar (local path or URL).

  • resolve_username

    Resolve @username to a user/channel/chat entity.

  • list_folders

    List custom dialog folders (chat filters).

  • list_contacts

    List contacts.

  • get_message

    Fetch one or more messages by id.

  • get_message_reactions

    Get reactions on messages.

  • mark_as_read

    Mark messages read up to an id.

  • edit_message

    Edit a previously sent message.

  • delete_messages

    Delete by id (optionally revoke for all).

  • forward_messages

    Forward messages between dialogs.

  • pin_message

    Pin / unpin in a dialog.

  • send_reaction

    Set reactions on a message.

  • send_message_to_phone

    Send to a phone number, auto-creates a temporary contact.

  • download_profile_photo

    Save a peer's avatar to disk.

  • send_poll

    Send a poll.

  • vote_poll

    Cast a vote.

  • close_poll

    Finalize a poll.

  • get_poll_results

    Fetch tally.

  • set_default_reaction

    Set account-wide default.

  • list_stories

    Feed of contacts' stories.

  • get_peer_stories

    One peer's stories.

  • send_story

    Post a story (photo or video).

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
Cline logo

Cline

Desktop · Free · MIT

An AI coding assistant integrated into the IDE. Supports MCP servers for enhanced functionality.

WindowsMacOSLinux
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
Windsurf logo

Windsurf

Desktop · Freemium · Proprietary

The first agentic IDE. The Windsurf editor truly merges how developers and AI work together.

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