Getting started

Pushpush lets you send push notifications to your phone with a single HTTP request or an MCP tool call from Claude Code.

Connect via MCP

Add Pushpush to Claude Code using the MCP CLI:

claude mcp add -t http \
  pushpush https://a.pushpu.sh/mcp

Then enable it in Claude Code:

/mcp enable pushpush

The first time you use a Pushpush tool, you’ll be prompted to sign in via your browser. This is where you’ll set up your account and payment.

Once connected, you get access to some tools:

send_push — Send a notification to a topic
list_messages — Read recent messages from a topic
get_token — Generate an API token for use with curl/scripts
manage_account — Get a link to manage your subscription, billing, and account settings

The tools are self-documenting, so you can simply ask the model to “help manage your Pushpush account” or “send me a push on the Claude topic”.

Receive notifications

Install the Pushpush iOS app and sign in. Subscribe to the topics you’re sending to, and notifications show up on your phone.

Pushpush iOS app

Send your first notification

Ask Claude Code:

Send a push notification to the “test” topic with the message “Hello from Claude Code”

You can also include a title, priority (1-5), and a URL to open on tap:

Send a push to “deploys” with message “v2.1.0 is live”, title “Deploy complete”, priority 4, and click URL https://example.com/status

Manage your account

To manage your account and billing, just ask to “manage your Pushpush account”. We’ll give you back a URL.

We use Kinde for authentication and billing, and you’ll manage your account using their account portal.

If you need help, let us know via support@pushpu.sh.

Get an API token

Ask Claude Code:

Get me a Push API token

This returns a JWT you can use with curl, scripts, CI pipelines — anything that can make HTTP requests. Tokens last 7 days by default.

For a non-expiring token (useful for automation):

Get me a Push API token that doesn’t expire

Use the API with curl

Send a notification (simple)

curl -X POST https://a.pushpu.sh/my-alerts \
  -H "Authorization: Bearer eyJhbG...your-token" \
  -d "Backup completed successfully"

The request body becomes the notification message. The URL path is the topic name.

Send a notification (rich)

curl -X POST https://a.pushpu.sh/ \
  -H "Authorization: Bearer eyJhbG...your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "deploys",
    "title": "Deploy complete",
    "message": "v2.1.0 deployed to production",
    "priority": 4,
    "actions": [
      { "action": "view", "label": "Open dashboard", "url": "https://example.com/dashboard" }
    ]
  }'

Poll for messages

curl https://a.pushpu.sh/my-alerts/json?since=1h \
  -H "Authorization: Bearer eyJhbG...your-token"

Returns newline-delimited JSON, one message per line.