mcpField
P
Pushover Notifications

Pushover Notifications

Local
jwowk.netCommunication0Updated 1w ago
RepositoryVisit website

About Pushover Notifications

Pushover Notifications is an MCP server for sending Pushover push notifications to phones and other devices. It supports notification delivery and related validation, sound, limit, and receipt operations.

Key features

  1. 01Send notifications with priority and sounds
  2. 02Validate users
  3. 03List available sounds
  4. 04Check and cancel emergency receipts
  5. 05Get API limits

Use cases

  1. 01Send an alert to a phone from an MCP client
  2. 02Validate a Pushover user key
  3. 03Check or cancel an emergency notification receipt

MCP support

Exposes Pushover API operations as MCP tools. It runs over stdio or Streamable HTTP and requires a Pushover application token.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "joshuawowk-pushover": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PUSHOVER_TOKEN",
        "-e",
        "PUSHOVER_USER_KEY",
        "ghcr.io/joshuawowk/pushover-mcp:1.0.1"
      ],
      "env": {
        "PUSHOVER_TOKEN": "<PUSHOVER_TOKEN>",
        "PUSHOVER_USER_KEY": "<PUSHOVER_USER_KEY>"
      }
    }
  }
}
Run commanddocker run -i --rm -e PUSHOVER_TOKEN -e PUSHOVER_USER_KEY ghcr.io/joshuawowk/pushover-mcp:1.0.1
Environment variables to set
PUSHOVER_TOKENSecretPushover application API token
PUSHOVER_USER_KEYSecretDefault Pushover user or group key

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocighcr.io/joshuawowk/pushover-mcp:1.0.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

pushover-mcp

Release License: MIT

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.