Getting Started

What is Pushary?

Pushary is a push notification platform with two products:

1. Agent Notifications — push notifications for AI coding agents (Cursor, Claude Code, Windsurf). Your agent notifies you when a task finishes and can ask yes/no questions you answer from your phone's lock screen.
2. Web Push Notifications — browser push notifications for websites. Reach users on desktop and mobile without a native app.

Pick the path that matches what you're building.

For AI coding agents

Get notified on your phone when Cursor, Claude Code, or any MCP-compatible agent finishes a task. Answer yes/no questions from your lock screen without switching back to your computer.

Setup takes 2 minutes:

1. Sign up and get your API key
2. Add Pushary to your MCP config (4 lines of JSON)
3. Subscribe to notifications on your phone
4. Start a long task — your phone buzzes when it's done

→ Agent Notifications: Getting Started

Or install the Pushary agent skill for any of 42+ AI coding tools:

npx skills add pushary/pushary-skill

For websites

Add push notifications to your website so you can reach users on desktop and mobile. No native app required.

Client SDK (@pushary/sdk)

Browser-side integration that handles subscription management, permission prompts, service worker registration, and click tracking.

npm install @pushary/sdk

import { createPushary } from '@pushary/sdk'

const pushary = createPushary({
  siteKey: 'pk_your_site_key',
  autoPrompt: true,
})

→ Client SDK Installation

Server SDK (@pushary/server)

Backend integration for sending notifications, managing subscribers, running campaigns, and building automation flows.

npm install @pushary/server

import { createPusharyServer } from '@pushary/server'

const pushary = createPusharyServer({
  apiKey: process.env.PUSHARY_API_KEY,
})

await pushary.notifications.send({
  title: 'Hello!',
  body: 'Welcome to Pushary',
  subscriberIds: ['sub_123'],
})

→ Server SDK Installation

Get your API key

Both products use the same API key system:

1. Go to Dashboard → Settings
2. Open the API Keys section
3. Click Create API Key and copy the key — it is only shown once
4. The key format is pk_xxx.secret_xxx

→ Authentication