MCP server: One MCP server.

Pushover Notifications

@joshuawowkMCP server · External

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

Push notificationsv1.0.0MITPython
Freeno charge per call

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: moves money, runs code or commands, deletes data, or sends messages for you.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

Dockerghcr.io/joshuawowk/pushover-mcp:1.0.0

Run

docker run -i --rm ghcr.io/joshuawowk/pushover-mcp:1.0.0

MCP client config

{
  "mcpServers": {
    "pushover-notifications": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/joshuawowk/pushover-mcp:1.0.0"
      ]
    }
  }
}
README1 min read

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

Run with Docker (stdio, e.g. Claude Desktop)

json
{
  "mcpServers": {
    "pushover": {
      "command": "docker",
      "args": ["run","-i","--rm","-e","PUSHOVER_TOKEN","-e","PUSHOVER_USER_KEY","ghcr.io/joshuawowk/pushover-mcp:latest"],
      "env": { "PUSHOVER_TOKEN": "your-app-token", "PUSHOVER_USER_KEY": "your-user-key" }
    }
  }
}

Self-host as a streamable-HTTP server

bash
cp .env.example .env   # fill in your tokens
docker compose up -d   # serves MCP at http://<host>:8735/mcp

Run from source

bash
pip install "mcp>=1.2,<2" "httpx>=0.27"
python pushover_mcp.py                 # stdio
python pushover_mcp.py --http --host 0.0.0.0 --port 8735   # HTTP

License

MIT © jwowk · https://jwowk.net

Similar modules

Browse Push notifications