MCP-Pushover Bridge

A Model Context Protocol (MCP) server that enables AI assistants to send push notifications via Pushover.

Features

• 📱 Send push notifications through Pushover API
• 🔄 Configurable retry logic with exponential backoff
• 🎛️ Support for all Pushover message parameters (title, priority, sound)
• ⚙️ Environment-based configuration
• 🔷 Full TypeScript support
• 🤖 Built for Claude Desktop and MCP-compatible clients

Installation

Quick Start (Recommended)

npx mcp-pushover

Global Installation

npm install -g mcp-pushover
mcp-pushover

From Source

git clone https://github.com/pyang2045/mcp-pushover.git
cd mcp-pushover
npm install
npm run build
npm start

Pushover Setup

Before using this MCP server, you need to set up Pushover:

1. Create Pushover Account

1. Sign up at pushover.net
2. Download the Pushover app on your mobile device
3. Note your User Key from the dashboard

2. Create Application

1. Go to pushover.net/apps/build
2. Create a new application (e.g., "MCP Bridge")
3. Note your API Token/Key

3. Test Your Setup

You can test your credentials using curl:

curl -s \
  --form-string "token=YOUR_API_TOKEN" \
  --form-string "user=YOUR_USER_KEY" \
  --form-string "message=Test from MCP-Pushover" \
  https://api.pushover.net/1/messages.json

Configuration

Environment Variables

Create a .env file or set these environment variables:

# Required (unless provided as tool parameters)
PUSHOVER_DEFAULT_TOKEN=your_pushover_app_token
PUSHOVER_DEFAULT_USER=your_pushover_user_key

# Optional
NODE_ENV=production
LOG_LEVEL=info
RETRY_MAX_ATTEMPTS=3
RETRY_INITIAL_DELAY=1000

Claude Desktop Integration

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pushover": {
      "command": "npx",
      "args": ["mcp-pushover"],
      "env": {
        "PUSHOVER_DEFAULT_TOKEN": "your_app_api_token",
        "PUSHOVER_DEFAULT_USER": "your_user_key"
      }
    }
  }
}

After updating the configuration, restart Claude Desktop to load the MCP server.

Available Tools

pushover_send_message

Send a notification via Pushover to your mobile device.

Parameters:

• message (required): The message content to send
• user_key (optional): Pushover user or group key (defaults to env var)
• api_token (optional): Pushover application API token (defaults to env var)
• title (optional): Message title
• priority (optional): Message priority:
  • -2: No notification/alert
  • -1: Quiet notification
  • 0: Normal priority (default)
  • 1: High priority
  • 2: Emergency priority (requires acknowledgment)
• sound (optional): Notification sound (pushover, bike, bugle, cashregister, classical, cosmic, falling, gamelan, incoming, intermission, magic, mechanical, pianobar, siren, spacealarm, tugboat, alien, climb, persistent, echo, updown, vibrate, none)

Example:

{
  "message": "Task completed successfully!",
  "title": "Claude Notification",
  "priority": 1,
  "sound": "magic"
}

Development

Setup

npm install
npm run build

Run in Development Mode

npm run dev

Testing

npm test

Manual Testing

# Build first
npm run build

# Run the test script
node test/manual-test.js

Security

• API tokens are never logged
• Supports environment variables for credential management
• All Pushover API calls use HTTPS

License

MIT