# Pushpush

> Simple notifications for agents & automation.

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

Website: https://pushpu.sh
API: https://a.pushpu.sh
iOS app: Pushpush on the App Store

## Quick start

1. Add the MCP server to Claude Code:

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

2. Use /mcp to sign up for Pushpush.

3. Install the Pushpush iOS app and sign in. Subscribe to the topics you want to receive.

4. Ask Claude Code:

   "Send me a push on the hello-world topic."

## MCP tools

Once connected via MCP, these tools are available:

- send_push - Send a notification to a topic (delivered to all subscribed devices)
- list_messages - Read recent messages from a topic
- get_token - Generate a Bearer token for use with the HTTP API (curl, scripts, CI)
- get_account_info - View account details (email, subscription, devices)
- manage_account - Get a link to manage subscription and billing
- help - Quick reference for all tools

## HTTP API

All API requests require a Bearer token in the Authorization header. Get one via the get_token MCP tool or ask Claude Code for a "Push API token".

### Send a notification (simple)

POST /{topic} with a plain text body:

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

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

### Send a notification (rich)

POST / with a JSON body:

  curl -X POST https://a.pushpu.sh/ \
    -H "Authorization: Bearer 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" }
      ]
    }'

You can also POST JSON to /{topic}:

  curl -X POST https://a.pushpu.sh/deploys \
    -H "Authorization: Bearer TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"title": "Deploy complete", "message": "v2.1.0 deployed to production"}'

### Poll for messages

GET /{topic}/json returns newline-delimited JSON:

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

## Message fields

- topic (required): Topic name (letters, digits, dash, underscore, dot; 1-64 chars)
- message: Notification body text
- title: Notification title (defaults to topic name)
- priority: 1 (min/passive) to 5 (urgent/time-sensitive). Default: 3
- click: URL to open when notification is tapped
- actions: Array of up to 3 action buttons, each with action, label, and url fields

## Account management

Authentication is handled via Kinde. To manage your account and billing, ask Claude Code to "manage my Pushpush account" or use the manage_account MCP tool.

Support: support@pushpu.sh

## Further reading

- Getting started: https://pushpu.sh/docs/using-pushpush
- Use cases: https://pushpu.sh/docs/use-cases
- MCP integration: https://pushpu.sh/docs/mcp
- Pricing: https://pushpu.sh/pricing
- Terms: https://pushpu.sh/docs/terms
- Privacy: https://pushpu.sh/docs/privacy