Pushover

What is Pushover MCP?

Pushover MCP is a Model Context Protocol (MCP) implementation that allows AI agents to send notifications through Pushover.net. It integrates seamlessly with MCP-compatible AI systems, providing a standardized way for AI to deliver instant notifications to various devices.

How to Use Pushover MCP?

To use Pushover MCP, you need an application token and your user key from Pushover.net. Once you have these credentials, you can install and configure the MCP. There are several methods for installation and usage:

Installing Globally (with Cursor)

1. Run the MCP server using npx: npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER
2. In Cursor IDE, go to Cursor Settings > MCP.
3. Click + Add New MCP Server.
4. Fill in the form with a name (e.g., "Pushover Notification"), type "command", and the command from step 1.

Project-specific Configuration (with Cursor or Roo Code)

1. Add an .cursor/mcp.json file to your project (for Cursor) or configure in Roo Code settings.
2. The JSON configuration should include mcpServers with a "pushover" entry, specifying the command and args for npx to start the server with your token and user key.

Installing via Smithery (for Claude Desktop)

Run the command: npx -y @smithery/cli install @AshikNesin/pushover-mcp --client claude

Using the Tool

Once configured, the Pushover notification tool will be available to the AI agent. The agent can automatically use it when relevant, or you can explicitly ask the agent to send notifications. By default, the agent will ask for approval before sending notifications, but "Yolo mode" can be enabled for automatic sending.

Key Features of Pushover MCP

• Seamless Integration: Implements the MCP specification for easy integration with MCP-compatible AI systems.
• Notification Sending: Provides a send tool for AI agents to send notifications via Pushover.net.
• Customizable Notifications: The send tool allows for customization of messages, titles, priorities, sounds, URLs, URL titles, and target devices.
• Multiple Installation Methods: Supports global installation, project-specific configuration, and installation via Smithery.

Use Cases of Pushover MCP

• AI Agent Alerts: AI agents can send critical alerts or important updates to users in real-time.
• Automated Reminders: AI-powered systems can send automated reminders for tasks, appointments, or events.
• System Monitoring: AI can notify administrators about system anomalies, errors, or performance issues.
• Workflow Notifications: Integrate into automated workflows to provide timely notifications about process completions or required actions.

FAQ about Pushover MCP

• What credentials do I need? You need an application token and your user key from Pushover.net.
• Can I customize the notifications? Yes, the send tool offers various parameters like title, priority, sound, and URL for customization.
• Does the AI agent ask for approval before sending notifications? By default, yes. However, you can enable "Yolo mode" in settings for automatic sending.
• What AI environments are supported? The project provides instructions for integration with Cursor and Roo Code, and installation via Smithery for Claude Desktop.

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