English Français العربية

Pushover Notifications

Official registry Other

Send push notifications to your devices and groups via the Pushover API.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

OCI package ghcr.io/joshuawowk/pushover-mcp:1.0.1
Claude Code 
claude mcp add pushover-notifications -e 'PUSHOVER_TOKEN=<your pushover_token>' -e 'PUSHOVER_USER_KEY=<your pushover_user_key>' -- docker run -i --rm ghcr.io/joshuawowk/pushover-mcp:1.0.1 --stdio
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pushover-notifications": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/joshuawowk/pushover-mcp:1.0.1",
                "--stdio"
            ],
            "env": {
                "PUSHOVER_TOKEN": "<your pushover_token>",
                "PUSHOVER_USER_KEY": "<your pushover_user_key>"
            }
        }
    }
}

Environment variables

  • PUSHOVER_TOKEN required secret Pushover application API token
  • PUSHOVER_USER_KEY secret Default Pushover user or group key

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. pushover-mcp
  2. Tools
  3. Configuration (environment variables)
  4. Install
  5. License

pushover-mcp

An MCP server for the Pushover notification API. Send push notifications to your phone and other devices from any MCP client. Single-file Python; runs over stdio or streamable HTTP.

Tools

send (full parameter coverage incl. priority, sounds, and emergency receipts), validate_user, list_sounds, get_limits, check_receipt, cancel_receipt.

Configuration (environment variables)

VariableRequiredDescription
PUSHOVER_TOKENyesPushover application API token
PUSHOVER_USER_KEYnoDefault user/group key (tools accept a user override)
PUSHOVER_DEVICEnoDefault device name(s), comma-separated
PUSHOVER_MCP_ALLOWED_HOSTSHTTP onlyHost:port values the DNS-rebinding guard accepts

Install

The server ships as a multi-arch container image on GHCR (and is listed in the MCP Registry as io.github.joshuawowk/pushover-mcp). Run with no arguments the image serves streamable HTTP on port 8735; pass --stdio for a stdio server.

Docker, stdio (e.g. Claude Desktop)
{
  "mcpServers": {
    "pushover": {
      "command": "docker",
      "args": ["run","-i","--rm","-e","PUSHOVER_TOKEN","-e","PUSHOVER_USER_KEY","ghcr.io/joshuawowk/pushover-mcp:latest","--stdio"],
      "env": { "PUSHOVER_TOKEN": "your-app-token", "PUSHOVER_USER_KEY": "your-user-key" }
    }
  }
}
Self-host as a streamable-HTTP server
cp .env.example .env   # fill in your tokens
docker compose up -d   # serves MCP at http://<host>:8735/mcp
Run from source
pip install "mcp>=1.2,<2" "httpx>=0.27"
python pushover_mcp.py                 # stdio (same as --stdio)
python pushover_mcp.py --http --host 0.0.0.0 --port 8735   # HTTP

License

MIT © jwowk · https://jwowk.net

Frequently asked questions

What is Pushover Notifications?

Send push notifications to your devices and groups via the Pushover API.

How do I install Pushover Notifications?

It runs on your machine. In Claude Code: claude mcp add pushover-notifications -e 'PUSHOVER_TOKEN=<your pushover_token>' -e 'PUSHOVER_USER_KEY=<your pushover_user_key>' -- docker run -i --rm ghcr.io/joshuawowk/pushover-mcp:1.0.1 --stdio. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Pushover Notifications need an API key?

Yes. It expects PUSHOVER_TOKEN, PUSHOVER_USER_KEY, which you set in its configuration.

Is Pushover Notifications open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Pushover Notifications?

It is published by joshuawowk. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.