Pushover

🚀 Pushover MCP

An implementation of Model Context Protocol on Pushover.net for sending notifications via Pushover.

🚀 Quick Start

This MCP allows AI agents to send notifications via Pushover.net. It implements the MCP specification, enabling seamless integration with compatible AI systems.

✨ Features

This MCP provides a tool to send notifications via Pushover.

📦 Installation

Using Cursor

Method 1: Global Installation

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 out the form:
   • Name: Pushover Notifications (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 a .cursor/mcp.json file to your project:

{
  "servers": {
    "pushover": {
      "command": "npx -y pushover-mcp"
    }
  }
}

Using Roo Code

1. Open your project and go to Settings > MCP.
2. Click Add New MCP Server.
3. Fill out the following information:
   • Name: Pushover Notifications
   • Type: Command
   • Command: npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER

💻 Usage Examples

Basic Usage

This MCP provides a tool:

send

Send a notification via Pushover.

{
  message: string;          // Required: The message to send
  title?: string;          // Optional: The message title
  priority?: number;       // Optional: -2 to 2 (-2: Lowest, 2: Emergency)
  sound?: string;         // Optional: Notification sound
  url?: string;          // Optional: Included link
  url_title?: string;   // Optional: Link title
  device?: string;     // Optional: Specify a device
}

Example MCP Tool Call

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

🔧 Technical Details

Configuration

You need:

1. An application token from Pushover.net.
2. Your user key. Get this information from your Pushover.net dashboard.

Development

To start development, follow these steps:

1. Install dependencies:

npm install

2. Build the project:

npm run build

3. Run tests:

npm test

📄 License

This project is licensed under the MIT License.