telegram-mcp

A remote MCP server that lets Claude send you Telegram messages, photos, and documents. Works with Claude.ai web, Claude Code, and scheduled tasks.

No server-side secrets. You provide your own bot token and chat ID when connecting. Credentials are encrypted in the OAuth token using AES-GCM with per-grant keys.

1. Create a bot via @BotFather on Telegram (or use an existing one)
2. Send /start to your bot so it can message you
3. Get your Chat ID from @userinfobot
4. Add the MCP server in Claude.ai > Settings > Connectors with this URL:

   https://telegram-mcp.maganuriyev.workers.dev/mcp

1. Enter your bot token and chat ID when prompted
2. You'll receive a confirmation message on Telegram

| Tool | Description | |------|-------------| | send_message | Send text with HTML formatting (<b>, <i>, <u>, <code>, <pre>, <a>, <blockquote>). Optional silent mode. | | send_photo | Send a photo by URL with optional caption | | send_document | Send a file/document by URL with optional caption |

> "Analyze this dataset and send me the results on Telegram when you're done"

Claude works through the task and sends you the summary on Telegram so you don't have to watch and wait.

Set up recurring tasks at claude.ai/code/scheduled or via /schedule in Claude Code. Each task runs on Anthropic's cloud (even when your computer is off) and can send results to your Telegram.

Morning news briefing > "Every morning at 8am, search for the latest AI research papers published in the last 24 hours. Summarize the top 5 and send them to my Telegram."

PR review digest > "Every weekday at 9am, check open PRs in my repos. Summarize what needs review and send a Telegram message."

Notion todo reminders > "Every day at 7pm, read my Notion tasks database. I