WireCat Telegram

Name: WireCat Telegram
Author: WireCatLabs

by WireCatLabsversion 0.116.0i★ –iRuns on your computer

Registry namedev.wirecat/tg-cli

Install

Overview

Description from the maker (original English)

Your Telegram account for agents: read, search and send messages. Sign in with the tg CLI first.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Chat & email

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
The registry lists no key to fill in.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

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

Run this in your terminal

claude mcp add tg-cli -- npx -y @wirecat/tg-cli mcp serve --profiles all

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

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

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain wirecat.dev (the registry checks domain ownership)
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Chat & emaili

More stars than 0% of the other 1762 servers in this category
Published to the registry more recently than 93% of the other 1762 servers in this category
Basic checks equal to or better than 100% of the other 1762 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is WireCat Telegram safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.116.0) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Vexa, emailmd, MCP WhatsApp Cloud

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Vexa

by Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

Runs in the cloud★ 2,949Apache-2.0Updated 2 months ago

Install

emailmd

by anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

Computer or cloud★ 1,385MITUpdated 30 days ago

Install

MCP WhatsApp Cloud

by codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

Runs on your computer★ 277MITUpdated 5 months ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

tg — Telegram CLI for AI agents

Your whole Telegram account in the terminal, searchable on your computer, and ready for Claude Code, Codex, Cursor or any agent — within limits you set.

Docs · Examples · WireCat

An example conversation (invented people, illustrative output):

You:    Use tg CLI. What did I promise anyone in the last three days?

Agent: (runs tg personal review 'date>3d': 12 chats) I owe · Alice Example — the invoice by Friday. "Alice Example", 24.09 Waiting on others · Bob Sample — the mock-up by 25.09. Not in "Design" yet You: Remind Bob about the mock-up. Agent: Draft: "Hi Bob, how is the mock-up going?" Send it? You: Yes.

Quick start

npm install -g @wirecat/tg-cli    # or: bun add -g @wirecat/tg-cli; pnpm: see docs/installation.md

tg skill install --for all # the agent skill, for Claude Code, Codex and Gemini CLI tg personal setup # app registration and login tg personal inbox # other people's unread messages, in every chat; nothing is marked read

A global install does not install the agent skill: tg personal setup offers it, or run tg skill install --for all. npm may warn that install scripts are blocked or "not yet covered by allowScripts" (@wirecat/tg-cli, better-sqlite3); that is harmless, and you need not allow them — why. On Windows, if tg is not found, open a new terminal, or use the PowerShell installer in the installation guide.

Allow about five minutes. tg personal setup registers your own Telegram app at my.telegram.org, logs in by QR code, checks your first chats and installs the agent skill. Downloading older history is a separate step.

It needs Node 22.19+ or 24+, or Bun, on macOS, Linux or Windows. Try it without installing: npx @wirecat/tg-cli --help.

More: installation guide · on wirecat.dev

What can you do?

Catch up. *"Use tg CLI. What came in since this morning, and who is waiting for my answer?"*

tg personal inbox

tg personal review 'date>1d'

Find anything. *"Use tg CLI. When did we agree on the venue with Alice?"* — an answer with the date and the message itself.

tg personal search all "venue"                # messages and notes on this computer, and Telegram's own search

By default the words also go to Telegram's server search; add --offline to keep the query on this computer.

Keep your promises. *"Use tg CLI. What did I promise, and what am I still waiting on?"* tg personal review hands over everything said since the last review in one call, your own messages too.

tg personal review --new                      # what changed since the last review --new

Run your groups. *"Use tg CLI. Which questions in Hiking has nobody answered?"*

tg personal review chat:Hiking --unanswered

tg personal chats events "Hiking" "time>=7d" # who joined, left, was added or removed

More: recipes, with a schedule and limits for each · on wirecat.dev

Built for AI agents

Your agent. Your Telegram. Your rules.

Agents with a terminal (for example Claude Code, Codex, Gemini CLI) run tg commands themselves. The bundled skill tells them how: tg personal setup --agent … or tg skill install puts it in place, and tg skill show prints it before login.
Apps without a terminal (for example Claude Desktop, Cursor and other MCP clients) connect to tg personal mcp serve. It comes with ready prompts: /catch-up, /review, /reply, /find, /open-tasks and /link-conversations.

tg personal mcp add claude-code  # or: tg personal mcp add codex

tg personal mcp config # the entry for Claude Desktop, Cursor and others

The profile can send by default, so mcp add stops first. Check the profile's permissions, then run it again with --allow-writes.

More: the MCP server · on wirecat.dev

Why tg?

Your whole account, not only bots. Every chat, group, channel and contact, with its history — tg is one more of your devices.
Local-first search. Everything read is kept on your computer. Search reads that copy and, by default, asks Telegram's own search too; --offline keeps the query on your computer.
Made for agents. One operation per call, the same JSON shape every time with --json, a fixed exit code for each kind of failure, an MCP server and a skill.
Safe by default. Reading marks nothing read. A profile decides which actions an agent may take, which chats it may send to, and how many messages an hour (30 by default). When a send's outcome is unknown, tg says so and gives a repeat command that Telegram does not deliver twice.
The full Bot API too. All 185 methods, next to the convenient bot commands.

More: compared with other tools · on wirecat.dev

Your account

tg works in your name, as one more of your devices. It is not a bot: it talks to Telegram over MTProto, Telegram's own API for client apps, with an app you register yourself. It sees your chats, their history, groups, channels and contacts.

tg personal chats list --limit 5

tg personal messages list "Book club" --limit 20 tg personal messages send "Book club" "Call at 3?" --reply-to tg personal reactions add "Book club" 👍 tg personal messages send me "Call mum" --at-time 2h # a reminder in Saved Messages in two hours tg personal messages send "Book club" "The minutes" --file minutes.pdf tg personal messages download "Book club" --output-dir ~/Downloads tg personal messages transcribe "Book club" # a voice message as text

Read. Chats, history, one message with its neighbours, other people's unread messages in every chat (tg personal inbox), everything since the last review (tg personal review), new messages as they arrive (tg personal watch), a message's files, voice messages as text.
Write. Markdown, replies, files, photos, videos and voice messages, silent and scheduled messages (they go out even with this computer off), edits, forwards, pins, reactions, polls, deletion — for you or for everyone.
Voice on your computer. Telegram transcribes for Premium accounts; tg can also run a speech model on this machine, downloaded only when you ask.
Contacts and the account. Add, rename, block and import contacts; your own aliases and notes for people; who you are logged in as, and every device logged in to the account.
One person. Their profile, when they were last seen, their messages per shared chat, and whether the account looks like a bot or a spammer.

More: using tg · on wirecat.dev · one person · on wirecat.dev

Log in and profiles

Every user registers their own Telegram app; tg personal setup or tg personal session start does it for you. The app keys go to the system keyring, and the session is a file only your user can read.

tg personal session start               # a QR code: Settings → Devices → Link Desktop Device

tg personal session start phone # or a phone number, the code and your 2FA password tg personal session start qr # without a terminal (an agent): the QR code as text to paste into the chat tg personal account show # who you are logged in as tg account list # every profile here, and who each is logged in as

Several accounts are several profiles, and the profile is the first word, not an option:

tg personal chats list     # profile "personal"

tg work chats list # profile "work" export TG_PROFILE=work # or for the whole shell session

tg never picks a profile for you, not even the only one: a command that uses an account and has no profile named stops and lists the profiles on this computer. Name one, or set TG_PROFILE for a whole shell session.

More: login and sessions · on wirecat.dev · profiles · on wirecat.dev

The local store and search

Everything tg reads is kept in a local store on your computer. Search runs over it and over Telegram by default; --offline answers from the store without connecting.

tg personal search messages 'contract chat:"Project Alpha"'

tg personal search messages "contract" --backend archive # local only tg personal messages sync "Project Alpha" --last 5000 --background tg personal store export "Project Alpha" --format markdown --output alpha.md tg personal messages evidence "Project Alpha" --json # bounded evidence for a chat brief tg personal server install # keep the store current as a systemd or launchd service tg personal store backup ~/tg-backup.db # a copy, safe while the store is in use

Search by words, people, dates, files, links and tags; save searches; find discussions by topic.

More: search · on wirecat.dev · the local store · on wirecat.dev

Groups you run

tg personal review chat:Hiking --unanswered   # questions nobody answered in 24 hours

tg personal chats events "Hiking" "time>=7d" # who joined, left, was added or removed, and by whom tg personal chats members list "Hiking" --all # everyone, with their role and when they were last seen tg personal topics list "Hiking" # a forum group's topics, newest activity first tg personal chats inspect https://t.me/+AbCdEf # where an invite link leads, without joining tg perso

Only the beginning is shown; read the rest in the repo

WireCat Telegram

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Chat & emaili

Common questions

Alternatives

Vexa

emailmd

MCP WhatsApp Cloud

README from the maker

tg — Telegram CLI for AI agents

Quick start

What can you do?

Built for AI agents

Why tg?

Your account

Log in and profiles

The local store and search

Groups you run