Skip to content
MCP server

WireCat Telegram

Let an agent read, search and send Telegram messages from your own account

Runs locally
Install
Platforms
CLI, telegram, macOS
Runs
Locally
Version
0.133.0
Listing updated
5 days ago

Similar MCP servers

About WireCat Telegram

WireCat Telegram is an MCP server for communication. It runs locally on your machine and is started by your AI client.

This works with your personal account and its chats, not a bot. After installing the tg CLI you run guided setup, scan a QR code in Telegram to link a desktop device and the tool checks your account and a few chats.

Telegram needs an api_id and api_hash for any program that connects, and the command can register or retrieve them for you. Downloading history is a separate choice you make.

Typical requests include catching up on unread messages, finding which chats await a reply, recalling promises you made, finding a message by date or link, and drafting replies. The docs cover Windows, macOS and Linux, and a MAX messenger variant.

Install

Run in a terminal

claude mcp add tg-cli -- npx -y @wirecat/tg-cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tg-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/tg-cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tg-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/tg-cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tg-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/tg-cli"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "tg-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/tg-cli"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "tg-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/tg-cli"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Personal account
Reads your own chats.
QR login
Link as a desktop device.
Message search
Find by conversation, date, link or file.
Reply help
Draft or send messages.
Guided setup
Handles app registration.
Terminal use
Usable by hand too.

Good for

  • Catch up on unread chats
  • List chats waiting on you
  • Recall commitments
  • Find a shared file

More servers for the same service

WireCat Telegram FAQ

Is it a bot?

No, it uses your personal account.

What are api_id and api_hash?

Credentials that identify the program to Telegram.

Does it download history?

Only if you choose to.

Which systems?

Windows, macOS and Linux.

How do I add WireCat Telegram to Claude Code?

Run this command in your terminal: claude mcp add tg-cli -- npx -y @wirecat/tg-cli

What are the best alternatives to WireCat Telegram?

The closest alternatives to WireCat Telegram are WireCat MAX, WireCat WhatsApp, Telegram Tools, WireCat Mail and Telegram (tg-mcp).

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers