# WireCat Telegram

WireCat Telegram — an MCP server that gives agents access to your whole Telegram account: local message search, sending, checking unread messages and group chats.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19 repo stars
- Author: WireCatLabs
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/WireCatLabs/tg-cli
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/wirecat-telegram

## What it does

Works via MTProto like a regular device. The agent reads chat history, searches the local copy and Telegram's server index, sends messages to allowed chats. A profile sets limits: how many messages per hour, which chats, which operations are permitted.

Comes with built-in prompts: `/catch-up`, `/review`, `/reply`, `/find`, `/open-tasks`, `/link-conversations`. Search queries go both to the local database and Telegram servers by default; the `--offline` flag keeps queries on your computer. Reading marks nothing read. When a send outcome is uncertain, the server provides a repeat command that Telegram will not deliver twice.

Requires Node 22.19+ or 24+, or Bun. Before connecting, run `tg personal setup`: it registers an app at `my.telegram.org`, signs in by QR code, and installs the agent skill.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add tg-cli -- npx -y @wirecat/tg-cli
```

### Codex

**Platform CLI**
```bash
codex mcp add wirecat-telegram -- npx -y @wirecat/tg-cli
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "wirecat-telegram": {
            "command": "npx",
            "args": [
                "-y",
                "@wirecat/tg-cli"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "wirecat-telegram": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@wirecat/tg-cli"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add wirecat-telegram npx -y @wirecat/tg-cli
```

## When to use it
- read messages from all chats and channels
- search local history and Telegram server index
- check who is waiting for a reply
- send a message to a specific chat with rate limits
- find promises and agreements in conversations

## Example prompts
- Find the conversation with Alice about the venue in Telegram
- Read what came in since this morning and tell me who is waiting for an answer
- Remind Bob about the mock-up in the `Design` chat

## Similar
- [claude-ops-telegram-server](https://affpapa.org/en/nevibecode/mcp/claude-ops-telegram-server.md) — MCP server · ★ 557 repo stars
- [fast-mcp-telegram](https://affpapa.org/en/nevibecode/mcp/fast-mcp-telegram.md) — MCP server · ★ 50 repo stars
- [Better Telegram MCP](https://affpapa.org/en/nevibecode/mcp/better-telegram-mcp.md) — MCP server · ★ 12 repo stars
- [telegram-mcp](https://affpapa.org/en/nevibecode/mcp/telegram-mcp.md) — MCP server · ★ 7 repo stars
- [telegram-archive-mcp](https://affpapa.org/en/nevibecode/mcp/telegram-archive-mcp.md) — MCP server · ★ 16 repo stars
- [telegram](https://affpapa.org/en/nevibecode/skills/acedatacloud-telegram.md) — skill · 189 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
