What is Pushover Mcp

pushover-mcp is an implementation of the Model Context Protocol (MCP) designed for sending notifications via Pushover.net, enabling AI agents to communicate effectively through notifications.

Use cases

Use cases for pushover-mcp include sending alerts for system monitoring, notifying users of important updates, and integrating with AI systems to provide real-time notifications based on specific triggers.

How to use

To use pushover-mcp, you need to obtain an application token and a user key from your Pushover.net dashboard. You can then run the MCP server using the command: npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER. You can also configure it in your project by adding a .cursor/mcp.json file.

Key features

Key features of pushover-mcp include the ability to send customizable notifications with various parameters such as message, title, priority, sound, and target device. It adheres to the MCP specification for seamless integration with compatible AI systems.

Where to use

pushover-mcp can be used in various fields where notifications are essential, such as in AI-driven applications, alert systems, and any scenario requiring timely communication.

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