Telegram Notifier

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.

Setup

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
   

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

Tools

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

Use Cases

Notify when done

"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.

Scheduled tasks

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. If there are overdue or due-today items, send me a Telegram reminder with the list."

Dependency security audit

"Every Monday, audit dependencies in my project for known vulnerabilities. If any new CVEs are found, send a Telegram alert with severity and affected packages."

Deployment health check

"Every 2 hours, check my production API endpoint health. If any endpoint returns an error or response time exceeds 2s, send me a Telegram alert."

Architecture

• Cloudflare Workers with Durable Objects (McpAgent)
• OAuth 2.1 via @cloudflare/workers-oauth-provider
• BYOK auth: credentials provided during OAuth flow, validated against the Telegram API, stored encrypted in token props
• Streamable HTTP transport (MCP spec 2024-11-05)

Self-hosting

git clone https://github.com/MahammadNuriyev62/telegram-mcp.git
cd telegram-mcp
npm install
npx wrangler kv namespace create OAUTH_KV
# Update the KV ID in wrangler.jsonc
npx wrangler deploy

No secrets to configure. Users provide their own credentials when connecting.

License

MIT