pushover-mcp

An MCP server for sending push notifications via Pushover.

Requirements

• Node.js 18+
• Pushover account with API token and user key

Installation

# Install globally from npm
npm install -g pushover-mcp

# Or use directly with npx
npx pushover-mcp

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PUSHOVER_API_TOKEN | Yes | Application API token from https://pushover.net/apps | | PUSHOVER_USER_KEY | Yes | User key from https://pushover.net |

Usage

Command Line

pushover-mcp

Claude Desktop Configuration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "pushover": {
      "command": "npx",
      "args": ["-y", "pushover-mcp"],
      "env": {
        "PUSHOVER_API_TOKEN": "your-api-token-here",
        "PUSHOVER_USER_KEY": "your-user-key-here"
      }
    }
  }
}

Claude Code

claude mcp add pushover-mcp \
  -e PUSHOVER_API_TOKEN=your-api-token-here \
  -e PUSHOVER_USER_KEY=your-user-key-here \
  -- npx -y pushover-mcp

Available Tools

send_notification

Send a push notification to your devices.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | message | string | Yes | - | The notification message body | | title | string | No | App name | Title shown at top of notification | | url | string | No | - | URL to include (tappable in notification) | | url_title | string | No | - | Label for the URL | | priority | integer | No | 0 | Priority: -2 (silent) to 2 (emergency) | | sound | string | No | device default | Notification sound name | | html | integer | No | 0 | Enable HTML formatting (0=plain, 1=HTML) | | monospace | integer | No | 0 | Enable monospace (0=off, 1=on). Cannot combine with html |

Example:

send_notification(
    message="Build completed successfully!",
    title="CI Pipeline",
    url="https://github.com/user/repo/actions",
    url_title="View Build",
    priority=1,
    sound="magic"
)

Development

Setup

git clone <repo-url>
cd pushover-mcp
npm install
npm run build

Build

npm run build

Project Structure

pushover-mcp/
├── src/
│   ├── index.ts        # Main entry point & MCP server
│   ├── types.ts        # Type definitions
│   └── pushover.ts     # Pushover API client
├── package.json
├── tsconfig.json
├── README.md
└── CLAUDE.md

License

MIT