English Français العربية

io.github.ParthJadhav/telegram-notify-mcp

Registre officiel Productivité

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • TELEGRAM_BOT_TOKEN obligatoire secret Telegram Bot API token from BotFather

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.ParthJadhav/telegram-notify-mcp ?

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

Comment installer io.github.ParthJadhav/telegram-notify-mcp ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.ParthJadhav/telegram-notify-mcp ?

Oui. Il attend TELEGRAM_BOT_TOKEN, à renseigner dans sa configuration.

io.github.ParthJadhav/telegram-notify-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.ParthJadhav/telegram-notify-mcp ?

Il est publié par ParthJadhav. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.