Pushover Mcp

What is Pushover-MCP?

Pushover-MCP is a powerful implementation designed for sending notifications through the Pushover service. It allows developers to easily integrate notification capabilities into their applications, enabling real-time alerts and updates. This tool is particularly useful for applications that require immediate user feedback or monitoring, such as server alerts, application status updates, or any other critical notifications.

Features of Pushover-MCP

• Easy Integration: Pushover-MCP can be seamlessly integrated into various applications, making it accessible for developers of all skill levels.
• Real-Time Notifications: Users receive instant notifications, ensuring they are always updated with the latest information.
• Customizable Alerts: Developers can customize the notifications to suit their application's needs, including setting priorities and sound options.
• Cross-Platform Support: Pushover-MCP works across different platforms, allowing notifications to be sent to mobile devices, desktops, and more.
• Open Source: Being an open-source project, it allows developers to contribute, modify, and enhance the functionality as needed.

How to Use Pushover-MCP

1. Installation: Begin by installing the Pushover-MCP package via npm:

   npm install pushover-mcp
   

2. Setup: After installation, you need to set up your Pushover application credentials. This typically involves creating an application on the Pushover website to obtain your API token.

3. Sending Notifications: Use the following code snippet to send a notification:

   const Pushover = require('pushover-mcp');
   
   const pushover = new Pushover({
       user: 'YOUR_USER_KEY',
       token: 'YOUR_API_TOKEN'
   });
   
   pushover.send({
       message: 'Hello, this is a test notification!',
       title: 'Test Notification'
   });
   

4. Customization: You can customize your notifications by adding additional parameters such as priority, sound, and title to tailor the alerts to your needs.

Frequently Asked Questions

What is Pushover?

Pushover is a service that allows users to send real-time notifications to their devices. It is widely used for alerting users about important events or updates.

Is Pushover-MCP free to use?

Yes, Pushover-MCP is an open-source project, and you can use it for free. However, Pushover itself may require a one-time purchase for the app on mobile devices.

Can I use Pushover-MCP in production?

Absolutely! Pushover-MCP is designed for production use, providing a reliable way to send notifications.

What programming languages does Pushover-MCP support?

Pushover-MCP is primarily designed for use with Node.js, but it can be integrated with any application that can make HTTP requests.

How can I contribute to Pushover-MCP?

You can contribute to the Pushover-MCP project by forking the repository on GitHub, making your changes, and submitting a pull request. Your contributions are welcome!

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