Skip to content
MCP server

Telegram (tg-mcp)

Remote MCP server that lets Claude, ChatGPT or Gemini read your Telegram chats

Responds, sign-in requiredStatus and history

The server answered 9 hours ago but needs an account or API key, so we could not list its tools.

Pricing
Open source
Platforms
self-hosted, API, Web
Runs
Remotely
Access
Needs an account or API key
Version
0.1.3
Listing updated
2 days ago

About Telegram (tg-mcp)

Telegram (tg-mcp) is an open-source MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

tg-mcp connects a personal Telegram account, not a bot, to an AI client. You add one URL as a custom connector, scan a QR code in Telegram under Settings, Devices, Link Desktop Device, and no API id or hash is needed. Reading is always included. Writing is opt-in: on the consent screen you can allow drafts that you send yourself, or messages to chats you choose, with reactions and read marks in those chats.

The site is candid about trust. Messages pass through the server's memory while your AI reads a chat, and your questions go to your AI provider. It suggests self-hosting for anyone who does not want to rely on the public instance, and the project publishes a 15 MB Docker image for amd64 and arm64. The session is stored encrypted with a key held by the AI app.

The maker, an independent developer, states that it is unofficial and not affiliated with Telegram. It uses Telegram's API through its own registered app, stays within rate limits and waits when asked, though the site says nobody can promise an account will never be affected.

Install

Run in a terminal

claude mcp add --transport http tg-mcp https://connector.tgmcp.dev/mcp

Add to Settings → Connectors → Add custom connector

https://connector.tgmcp.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tg-mcp": {
      "url": "https://connector.tgmcp.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tg-mcp": {
      "type": "http",
      "url": "https://connector.tgmcp.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tg-mcp": {
      "serverUrl": "https://connector.tgmcp.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tg-mcp": {
      "type": "http",
      "url": "https://connector.tgmcp.dev/mcp"
    }
  }
}

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

whoami
Returns the connected account and its chat folders.
list_chats
Lists chats, most recent first, with unread counts and previews; supports folders and unread-only filtering.
get_messages
Returns messages of one chat with sender, date, text and media details.
save_draft
Puts text into a chat's message field for you to send; needs the drafts permission.
send_message
Sends a message to a chosen chat; needs the send permission.
react
Reacts to a message in an allowed chat.
mark_read
Marks messages as read in an allowed chat.

What it does

QR code login
Links a personal account the way Telegram Desktop does, with no API key.
Read and search chats
Lists chats, reads messages and handles media such as photos and voice messages.
Opt-in writing
Drafts and sent messages are separate permissions you tick on the consent screen.
Chat selection for sending
Sending is limited to chats you choose, such as folders or recent chats.
Self-hosting
One Docker command runs your own copy of the MIT-licensed server.
Works in many clients
Claude, ChatGPT, Gemini, Claude Code, Cursor and other streamable-HTTP clients.

Good for

  • Catch up on unread chats after time away
  • Search old conversations for a detail
  • Summarise a busy group chat
  • Draft a reply that you review and send yourself
  • Transcribe voice messages through your AI

Pricing

Open source

Free and MIT licensed; self-hosting or the public instance

Prices change. Check tgmcp.dev before you buy.

Telegram (tg-mcp) FAQ

Is it free?

Yes. The site says there is no sign-up, payment or API key, and the code is MIT licensed.

How is it different from local Telegram MCP servers?

It is a remote server added by URL, so it also works in web and mobile AI apps, with no Python or Node install or API id.

Can the AI send messages without asking?

Only if you tick Send messages and pick the chats. Whether you are asked first is up to your AI app.

Can Telegram block my account?

It uses the official API and respects rate limits, but the site says nobody can honestly promise nothing will ever happen.

Is Telegram (tg-mcp) free?

Yes. Telegram (tg-mcp) is open source, so you can use and self-host it for free.

How do I add Telegram (tg-mcp) to Claude Code?

Run this command in your terminal: claude mcp add --transport http tg-mcp https://connector.tgmcp.dev/mcp

What are the best alternatives to Telegram (tg-mcp)?

The closest alternatives to Telegram (tg-mcp) are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to Telegram (tg-mcp)

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity