Jon's Pushover

You run a Python-based MCP server that sends push notifications to Pushover-enabled devices. It provides a simple MCP endpoint you can call from any MCP client to trigger notifications on your devices via the Pushover API.

How to use

To use this MCP server, connect your MCP client to the local server using the standard MCP protocol. You will invoke the available tool to send push notifications. The primary tool is send_notification, which takes a message and optional metadata to deliver a push notification to your devices via Pushover. You can tailor the notification with a title, a URL, and a priority or a custom sound.

How to install

# Prerequisites
# - Python 3.10+
# - A Pushover account with an API token and a user key

# Clone the project
git clone <your-repo-url>
cd jons-mcp-pushover

# Install with uv
uv pip install -e .

Additional setup and notes

After you have installed the server, you can run it and configure it for your environment. The server expects two environment variables: PUSHOVER_API_TOKEN and PUSHOVER_USER_KEY. Provide these values to authorize API calls to Pushover.

# Start the MCP server
uv run jons-mcp-pushover

Configuration and integration tips

If you use Claude Desktop to manage MCP servers, you can add a configuration entry that launches the server with the required environment variables. For example, specify the runtime as uv, pass the project path, and set the Pushover credentials in the environment.

{
  "mcpServers": {
    "pushover": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/jons-mcp-pushover", "jons-mcp-pushover"],
      "env": {
        "PUSHOVER_API_TOKEN": "your-api-token-here",
        "PUSHOVER_USER_KEY": "your-user-key-here"
      }
    }
  }
}

Adding to Claude Code

Register the MCP server with Claude Code and supply the required environment variables. This enables in-editor access to the server from your Claude workflow.

# Register the MCP server with Claude Code
claude mcp add jons-mcp-pushover \
  -e PUSHOVER_API_TOKEN=your-api-token-here \
  -e PUSHOVER_USER_KEY=your-user-key-here \
  -- uv run --directory /path/to/jons-mcp-pushover jons-mcp-pushover

Tools and usage example

The server exposes a tool to send push notifications. Use it by providing a message and optional metadata such as title, URL, priority, and sound to customize the notification.

send_notification(
    message="Build completed successfully!",
    title="CI Pipeline",
    url="https://github.com/user/repo/actions",
    url_title="View Build",
    priority=1,
    sound="magic"
)

Available tools

send_notification

Send a push notification to your devices. Requires a message and can include an optional title, URL, URL title, priority, and sound to customize the notification.