mcp-pushover

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

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

2. Create Application

• Go to pushover.net/apps/build
• Create a new application (e.g., "MCP Bridge")
• 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