WireCat Telegram
Let an agent read, search and send Telegram messages from your own account
- Platforms
- CLI, telegram, macOS
- Runs
- Locally
- Version
- 0.133.0
- Listing updated
- 5 days ago
Similar MCP servers
About WireCat Telegram
WireCat Telegram is an MCP server for communication. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add tg-cli -- npx -y @wirecat/tg-cliAdd to claude_desktop_config.json
{
"mcpServers": {
"tg-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/tg-cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tg-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/tg-cli"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tg-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/tg-cli"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tg-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/tg-cli"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tg-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/tg-cli"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- 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
More servers for the same service
WireCat Telegram 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.