Skip to main content
MCP server CX Codex

WireCat Telegram — Claude Code MCP server: what it does

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

Apache-2.0 ★ 19 updated 2026-10-29

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add tg-cli -- npx -y @wirecat/tg-cli
Open on GitHub

What WireCat Telegram 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.

What it helps with

  • 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 for the agent

  • 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

How to install WireCat Telegram

Platform CLI

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

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about WireCat Telegram

How to install WireCat Telegram in Claude Code?

Run claude mcp add tg-cli -- npx -y @wirecat/tg-cli. Before connecting, you need to run tg personal setup to register the app and sign in.

What does WireCat Telegram do?

Gives agents access to your whole Telegram account: reading, searching the local copy and server index, sending messages with limits you define in the profile.

What limits can I set for the agent?

The profile decides which operations are allowed, which chats the agent can send to, and how many messages per hour. The default limit is 30 messages per hour.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open