telegram-notify

Local install

io.github.yybd/telegram-notify-mcpv0.1.2 GitHub verified

Send-only Telegram notifications to one fixed chat. No polling, no recipient override, 2 tools.

Communication

Watch Source Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-07T22:22:33.107537Z",
      "publishedAt": "2026-11-07T22:22:33.107537Z",
      "statusChangedAt": "2026-11-07T22:22:33.107537Z"
    }
  },
  "server": {
    "name": "io.github.yybd/telegram-notify-mcp",
    "title": "telegram-notify",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.1.2",
    "packages": [
      {
        "version": "0.1.2",
        "transport": {
          "type": "stdio"
        },
        "identifier": "@yybd/telegram-notify-mcp",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "TELEGRAM_BOT_TOKEN",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "description": "Bot token from @BotFather (or run `telegram-notify-mcp setup` to save it to a file instead)"
          },
          {
            "name": "TELEGRAM_CHAT_ID",
            "format": "string",
            "isRequired": true,
            "description": "The one chat that receives every message; tools cannot change it"
          },
          {
            "name": "TELEGRAM_NOTIFY_FILES_DIR",
            "format": "string",
            "description": "Folder notify_file may send from. Unset means file sending is off"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/yybd/telegram-notify-mcp",
      "source": "github"
    },
    "websiteUrl": "https://github.com/yybd/telegram-notify-mcp#readme",
    "description": "Send-only Telegram notifications to one fixed chat. No polling, no recipient override, 2 tools."
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM StudioThen replace the YOUR_ values and {placeholders} with your own.

Run in a terminal

claude mcp add telegram-notify-mcp \
  -e TELEGRAM_BOT_TOKEN=YOUR_TELEGRAM_BOT_TOKEN \
  -e TELEGRAM_CHAT_ID=YOUR_TELEGRAM_CHAT_ID \
  -- npx -y @yybd/[email protected]

Environment

TELEGRAM_BOT_TOKEN (required): Bot token from @BotFather (or run `telegram-notify-mcp setup` to save it to a file instead)
TELEGRAM_CHAT_ID (required): The one chat that receives every message; tools cannot change it
TELEGRAM_NOTIFY_FILES_DIR (optional, not in the config above): Folder notify_file may send from. Unset means file sending is off

Tools

We don't run packages, so we can't list this server's tools.