English Français العربية

io.github.ParthJadhav/telegram-notify-mcp

السجل الرسمي الإنتاجية

Send Telegram notifications from AI agents — text, photos, and documents.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @parthj/telegram-notify-mcp
Claude Code 
claude mcp add telegram-notify-mcp -e 'TELEGRAM_BOT_TOKEN=<your telegram_bot_token>' -- npx -y @parthj/telegram-notify-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "telegram-notify-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@parthj/telegram-notify-mcp@1.0.1"
            ],
            "env": {
                "TELEGRAM_BOT_TOKEN": "<your telegram_bot_token>"
            }
        }
    }
}

متغيرات البيئة

  • TELEGRAM_BOT_TOKEN إلزامي سري Telegram Bot API token from BotFather

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Telegram Notify MCP
  2. Quick Start
  3. Configuration
  4. Tools
  5. How It Works
  6. Development
  7. License

Telegram Notify MCP

A dead-simple MCP server with one job: send AI agent progress back to you on Telegram.

That's it. No chat management, no group administration, no inline queries. Just notifications — as text, images, or files.

You kick off an agent, walk away, and get a Telegram message when it's done (or while it's working). Nothing more, nothing less.

Quick Start

1. Create a Telegram Bot
  1. Message @BotFather on Telegram
  2. Send /newbot and follow the prompts
  3. Copy the bot token
2. Start a chat with your bot

Find your bot on Telegram and send /start. This is required so the bot can discover your chat ID.

3. Add to your MCP client
Claude Code
claude mcp add telegram -e TELEGRAM_BOT_TOKEN=your-token -e TELEGRAM_USERNAME=your-username -- npx @parthj/telegram-notify-mcp
Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@parthj/telegram-notify-mcp"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-bot-token",
        "TELEGRAM_USERNAME": "your-telegram-username"
      }
    }
  }
}

Configuration

Environment VariableRequiredDescription
TELEGRAM_BOT_TOKENYesBot token from @BotFather
TELEGRAM_USERNAMEYesYour Telegram username (without the @)

Tools

Three tools. That's the entire surface area.

send_message

Send a text update to the user.

ParameterTypeRequiredDescription
textstringYesThe message text
parse_modestringNoHTML, Markdown, or MarkdownV2
send_photo

Send an image — a screenshot, a chart, a generated visual.

ParameterTypeRequiredDescription
photostringYesURL or absolute file path
captionstringNoPhoto caption
parse_modestringNoCaption formatting mode
send_document

Send a file — a report, a log, a build artifact.

ParameterTypeRequiredDescription
documentstringYesURL or absolute file path
captionstringNoDocument caption
parse_modestringNoCaption formatting mode

How It Works

  • On the first tool call, the server resolves your username to a chat ID via the Telegram Bot API's getUpdates
  • Sending /start to the bot is required — Telegram bots can only message users who have initiated a conversation
  • The chat ID is cached for the lifetime of the process

Development

git clone https://github.com/ParthJadhav/telegram-notify-mcp.git
cd telegram-notify-mcp
npm install
npm run build

License

MIT

الأسئلة الشائعة

ما هو io.github.ParthJadhav/telegram-notify-mcp؟

Send Telegram notifications from AI agents — text, photos, and documents.

كيف أثبّت io.github.ParthJadhav/telegram-notify-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add telegram-notify-mcp -e 'TELEGRAM_BOT_TOKEN=<your telegram_bot_token>' -- npx -y @parthj/telegram-notify-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ParthJadhav/telegram-notify-mcp إلى مفتاح API؟

نعم. يتطلب TELEGRAM_BOT_TOKEN، وتضبطها في إعداداته.

هل io.github.ParthJadhav/telegram-notify-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ParthJadhav/telegram-notify-mcp؟

ينشره ParthJadhav. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.