tg-mcp-server 1.0.0

MCP server for Claude: Telegram broadcast via Telethon

Telegram Broadcast for Claude

Send messages in Telegram via Claude Desktop.

Setup

1. Unpack the archive to any folder
2. Run install.bat (double-click)
3. It will install everything and ask for Telegram codes — enter them when Telegram sends them to your phone
4. At the end it will show a config — copy it into Claude Desktop (Settings -> Developer -> Edit Config)
5. Restart Claude Desktop

How to use

Just type in Claude chat:

• "Show my accounts"
• "What folders are on [phone]?"
• "Send to everyone in folder Clients: Hello! Are you interested in adding members to your chat?"
• "How is the broadcast going?"
• "Stop broadcast"
• "How many sent today?"

Claude will rephrase the message for each recipient automatically.

Settings

Edit .env file to change daily message limit (default 20) and delay between messages (60-180 seconds).

Troubleshooting

• Claude doesn't see the server — check the config path, restart Claude Desktop
• "Account not authorized" — run install.bat again
• Telegram blocked the account — ask Claude: "Check spam status on [phone]"