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
claude mcp add tg-cli -- npx -y @wirecat/tg-cliWhat 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
Designchat
How to install WireCat Telegram
Platform CLI
claude mcp add tg-cli -- npx -y @wirecat/tg-cliPlatform CLI
codex mcp add wirecat-telegram -- npx -y @wirecat/tg-cliConfig file
{
"mcpServers": {
"wirecat-telegram": {
"command": "npx",
"args": [
"-y",
"@wirecat/tg-cli"
]
}
}
}Config file
{
"servers": {
"wirecat-telegram": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/tg-cli"
]
}
}
}Platform CLI
gemini mcp add wirecat-telegram npx -y @wirecat/tg-cliStep 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.