# WireCat Telegram

> WireCat Telegram is an MCP server for communication. Let an agent read, search and send Telegram messages from your own account. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, telegram, macOS, Windows, Linux
- **Website:** https://wirecat.dev/en/docs/tg
- **Repository:** https://github.com/wirecatlabs/tg-cli
- **MCP Registry name:** dev.wirecat/tg-cli
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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.

## Alternatives

- [WireCat MAX](https://ai-powered.com/mcp/wirecat-max): WireCat MAX is an MCP server for communication.
- [WireCat WhatsApp](https://ai-powered.com/mcp/wirecat-whatsapp): WireCat WhatsApp is an MCP server for communication.
- [Telegram Tools](https://ai-powered.com/mcp/telegram-tools): Telegram Tools is an open-source MCP server for communication.
- [WireCat Mail](https://ai-powered.com/mcp/wirecat-mail): WireCat Mail is an open-source MCP server for communication.
- [Telegram (tg-mcp)](https://ai-powered.com/mcp/telegram-tg-mcp): Telegram (tg-mcp) is an open-source MCP server for communication.
- [WireCat pbx](https://ai-powered.com/mcp/wirecat-pbx): WireCat pbx is an open-source MCP server for communication.
- [FinchGram](https://ai-powered.com/mcp/finchgram): FinchGram is an open-source MCP server for communication.
- [Telegram Archive](https://ai-powered.com/mcp/telegram-archive): Telegram Archive is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/wirecat-telegram
