Pushover MCP

What is Pushover MCP about?

Pushover MCP provides an MCP‑compatible server that lets AI agents send notifications via the Pushover service. It exposes a single tool (send) that accepts message content and optional parameters such as title, priority, sound, URL, and target device.

How to use Pushover MCP?

1. Obtain a Pushover application token and your user key from the Pushover dashboard.
2. Start the server with the supplied CLI command (recommended via npx):

   npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER
   

3. Register the server in your IDE (Cursor, Roo Code, etc.) by adding the command or an .cursor/mcp.json configuration.
4. Once registered, AI agents can invoke the send tool with a JSON payload, e.g.:

   {
     "name": "send",
     "params": {
       "message": "Hello from AI",
       "title": "AI Notification",
       "priority": 1
     }
   }
   

Key features of Pushover MCP

• Single send tool covering the full Pushover API surface.
• Supports optional fields: title, priority (‑2 to 2), sound, URL with title, and device targeting.
• Easy global or project‑specific installation via npx.
• Works out‑of‑the‑box with Cursor, Roo Code, and Claude Desktop (via Smithery).
• Built‑in safety: agents request approval before sending unless “Yolo mode” is enabled.

Use cases of Pushover MCP

• Alerting developers of CI/CD pipeline results directly to their phones.
• Notifying users when an AI‑driven workflow finishes a long‑running task.
• Sending real‑time status updates from autonomous agents running on servers.
• Delivering critical error or security incident messages with high priority and custom sounds.

FAQ from the Pushover MCP

Q: Do I need to install anything besides Node.js? A: No. The server runs with npx, which pulls the package on demand.

Q: Can I run the server locally without internet? A: The server needs to reach api.pushover.net, so an internet connection is required for sending notifications.

Q: How do I secure my token and user key? A: Use environment variables or secret management in your IDE configuration instead of hard‑coding them in scripts.

Q: What priorities are available? A: Values from ‑2 (lowest) to 2 (emergency). Emergency priority triggers repeat alerts until dismissed.

Q: Is there a way to test the integration? A: Invoke the send tool with a simple message and verify it appears on your device.

Pushover MCP

A Model Context Protocol implementation for sending notifications via Pushover.net.

Overview

This MCP enables AI agents to send notifications through Pushover.net. It implements the MCP specification, allowing seamless integration with MCP-compatible AI systems.

Configuration

You'll need:

1. An application token from Pushover.net
2. Your user key from Pushover.net

Get these from your Pushover.net dashboard.

Tool Schema

The MCP provides a single tool:

send

Sends a notification via Pushover.

{
  message: string;          // Required: The message to send
  title?: string;          // Optional: Message title
  priority?: number;       // Optional: -2 to 2 (-2: lowest, 2: emergency)
  sound?: string;         // Optional: Notification sound
  url?: string;          // Optional: URL to include
  url_title?: string;   // Optional: Title for the URL
  device?: string;     // Optional: Target specific device
}

Example MCP Tool Call

{
  "name": "send",
  "params": {
    "message": "Hello from AI",
    "title": "AI Notification",
    "priority": 1
  }
}

Installing

Using with Cursor

Method 1: Install Globally

Run the MCP server using npx:

npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER

In your Cursor IDE

1. Go to Cursor Settings > MCP
2. Click + Add New MCP Server
3. Fill in the form:
   • Name: Pushover Notification (or any name you prefer)
   • Type: command
   • Command: npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER

Method 2: Project-specific Configuration

Add an .cursor/mcp.json file to your project:

{
  "mcpServers": {
    "pushover": {
      "command": "npx",
      "args": [
        "-y",
        "pushover-mcp@latest",
        "start",
        "--token",
        "YOUR_TOKEN",
        "--user", 
        "YOUR_USER"
      ]
    }
  }
}

Using the Tool

Once configured, the Pushover notification tool will be automatically available to the Cursor AI Agent. You can:

1. The tool will be listed under Available Tools in MCP settings
2. Agent will automatically use it when relevant
3. You can explicitly ask Agent to send notifications

By default, Agent will ask for approval before sending notifications. Enable "Yolo mode" in settings to allow automatic sending.

Using with Roo Code

Access the MCP settings by clicking “Edit MCP Settings” in Roo Code settings or using the “Roo Code: Open MCP Config” command in VS Code's command palette.

{
  "mcpServers": {
    "pushover": {
      "command": "npx",
      "args": [
        "-y",
        "pushover-mcp@latest",
        "start",
        "--token",
        "YOUR_TOKEN",
        "--user", 
        "YOUR_USER"
      ]
    }
  }
}

3. The Pushover notification tool will be available to Roo Code's AI agents

Note: Replace YOUR_TOKEN & YOUR_USER with your Pushover credentials.

Installing via Smithery

To install Pushover Notification for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @AshikNesin/pushover-mcp --client claude

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Run tests
pnpm test

License

MIT