pyang2045/mcp-pushover

MCP-Pushover Bridge

A Model Context Protocol (MCP) server that enables AI assistants to send push notifications via Pushover. Perfect for getting instant mobile alerts when Claude completes tasks, encounters errors, or when you want to send yourself messages through your AI assistant.

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. Note your User Key from the dashboard

2. Download Pushover App

1. Install the Pushover app on your mobile device:
   • iOS: Download from App Store
   • Android: Download from Google Play
2. Log in with your Pushover account credentials

3. Create Application

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

4. 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"
}

Use Cases

Personal Messaging

Ask Claude to send yourself reminders or messages:

• "Send me a notification to call mom at 5 PM"
• "Remind me to check the server logs"
• "Send a message saying the backup is complete"

Task Completion Alerts

Get notified when Claude finishes work:

• "Let me know when you're done analyzing this data"
• "Send me a notification when the report is ready"
• "Alert me if you find any errors in the code"

Workflow Integration

Integrate with your daily routines:

• Morning briefings and daily summaries
• Build completion and deployment notifications
• Error monitoring and system alerts
• Meeting reminders and calendar notifications

Emergency Notifications

High-priority alerts that require immediate attention:

• System failures or critical errors
• Security alerts or unusual activity
• Time-sensitive reminders
• Urgent task completions

Simply ask Claude: "Send me a push notification that says 'Deploy completed successfully'" and you'll receive it instantly on your mobile device!

Security

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

License

MIT