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.

Related MCP server: ntfy-cf

Configuration (environment variables)

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