Set up push notifications for Claude Code, Codex, Hermes, Cursor, or any MCP agent in under 5 minutes

Fastest setup for any agent: npx @pushary/agent-hooks setup detects Claude Code, Codex, Hermes, and Cursor and configures everything in one command.

Prerequisites

An AI coding tool that supports MCP (Claude Code, Codex, Hermes, Cursor, Windsurf, or any MCP client)
A phone or desktop browser for receiving notifications

Create your Pushary account

During onboarding, you'll choose a handle (your personal notification channel) and get your API key. Copy the API key immediately, it's only shown once.

The key looks like this: pk_abc123.sk_xyz789

Connect your AI agent

Choose your tool below and add the Pushary MCP server.

Run this command in your terminal:

claude mcp add pushary --transport http https://pushary.com/api/mcp/mcp --header "Authorization:Bearer pk_abc123.sk_xyz789"

Replace pk_abc123.sk_xyz789 with your actual API key.

For permission hooks and event tracking, see the Claude Code guide.

Run this command in your terminal:

codex mcp add pushary --url https://pushary.com/api/mcp/mcp --bearer-token-env-var PUSHARY_API_KEY

Set your API key in your shell profile:

export PUSHARY_API_KEY="pk_abc123.sk_xyz789"

For notify handler setup, see the Codex guide.

Install the native plugin:

pip install hermes-plugin-pushary
hermes plugins enable pushary

Set your API key:

export PUSHARY_API_KEY="pk_abc123.sk_xyz789"

For more options, see the Hermes guide.

Option A: One-click install

During onboarding, click the "Add to Cursor" button. This opens Cursor and adds Pushary automatically with your API key.

Option B: Manual config

Open Cursor Settings > MCP > Add Server, or add this to your mcp.json:

{
  "pushary": {
    "url": "https://pushary.com/api/mcp/mcp",
    "headers": {
      "Authorization": "Bearer pk_abc123.sk_xyz789"
    }
  }
}

Replace pk_abc123.sk_xyz789 with your actual API key.

Add this to your MCP configuration file (the location varies by tool):

{
  "pushary": {
    "url": "https://pushary.com/api/mcp/mcp",
    "headers": {
      "Authorization": "Bearer pk_abc123.sk_xyz789"
    }
  }
}

Replace pk_abc123.sk_xyz789 with your actual API key.

For stdio-only clients (tools that don't support HTTP MCP transport), use the mcp-remote bridge:

{
  "pushary": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://pushary.com/api/mcp/mcp",
      "--header",
      "Authorization:Bearer pk_abc123.sk_xyz789"
    ]
  }
}

Your agent can send notifications, but you need to subscribe to receive them.

Open your Pushary dashboard on your phone's browser (or scan the QR code shown during onboarding)
Your browser will ask for notification permission. Tap Allow
On iPhone: you may need to Add to Home Screen first (Share > Add to Home Screen), then open the app and enable notifications
On Android: permission works immediately in Chrome, Edge, or Firefox

Detailed phone setup guide

Send your first notification

Ask your agent to send a test:

Send me a test notification via Pushary saying "hello from Cursor"

Your phone should buzz within 2 seconds.

Now try human-in-the-loop:

Before you refactor this file, ask me via Pushary push notification if I want to keep backward compatibility

Your phone will show the question with Yes/No buttons. Tap your answer and the agent continues.

Human-in-the-loop guide

What your agent can do

Once connected, your agent has access to these tools:

Tool	What it does
`send_notification`	Send a push notification with optional rich context (files changed, errors, next steps)
`ask_user`	Ask a question: yes/no, multiple choice, or free text
`wait_for_answer`	Poll for your response to a question
`cancel_question`	Cancel a pending question that's no longer relevant

Plus 15 more tools for managing subscribers, campaigns, templates, and automation flows.

Full tools reference

Fastest setup for any agent: npx @pushary/agent-hooks setup detects Claude Code, Codex, Hermes, and Cursor and configures everything in one command.

Prerequisites

An AI coding tool that supports MCP (Claude Code, Codex, Hermes, Cursor, Windsurf, or any MCP client)
A phone or desktop browser for receiving notifications

Create your Pushary account

During onboarding, you'll choose a handle (your personal notification channel) and get your API key. Copy the API key immediately, it's only shown once.

The key looks like this: pk_abc123.sk_xyz789

Connect your AI agent

Choose your tool below and add the Pushary MCP server.

Run this command in your terminal:

claude mcp add pushary --transport http https://pushary.com/api/mcp/mcp --header "Authorization:Bearer pk_abc123.sk_xyz789"

Replace pk_abc123.sk_xyz789 with your actual API key.

For permission hooks and event tracking, see the Claude Code guide.

Run this command in your terminal:

codex mcp add pushary --url https://pushary.com/api/mcp/mcp --bearer-token-env-var PUSHARY_API_KEY

Set your API key in your shell profile:

export PUSHARY_API_KEY="pk_abc123.sk_xyz789"

For notify handler setup, see the Codex guide.

Install the native plugin:

pip install hermes-plugin-pushary
hermes plugins enable pushary

Set your API key:

export PUSHARY_API_KEY="pk_abc123.sk_xyz789"

For more options, see the Hermes guide.

Option A: One-click install

During onboarding, click the "Add to Cursor" button. This opens Cursor and adds Pushary automatically with your API key.

Option B: Manual config

Open Cursor Settings > MCP > Add Server, or add this to your mcp.json:

{
  "pushary": {
    "url": "https://pushary.com/api/mcp/mcp",
    "headers": {
      "Authorization": "Bearer pk_abc123.sk_xyz789"
    }
  }
}

Replace pk_abc123.sk_xyz789 with your actual API key.

Add this to your MCP configuration file (the location varies by tool):

{
  "pushary": {
    "url": "https://pushary.com/api/mcp/mcp",
    "headers": {
      "Authorization": "Bearer pk_abc123.sk_xyz789"
    }
  }
}

Replace pk_abc123.sk_xyz789 with your actual API key.

For stdio-only clients (tools that don't support HTTP MCP transport), use the mcp-remote bridge:

{
  "pushary": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://pushary.com/api/mcp/mcp",
      "--header",
      "Authorization:Bearer pk_abc123.sk_xyz789"
    ]
  }
}

Your agent can send notifications, but you need to subscribe to receive them.

Open your Pushary dashboard on your phone's browser (or scan the QR code shown during onboarding)
Your browser will ask for notification permission. Tap Allow
On iPhone: you may need to Add to Home Screen first (Share > Add to Home Screen), then open the app and enable notifications
On Android: permission works immediately in Chrome, Edge, or Firefox

Detailed phone setup guide

Send your first notification

Ask your agent to send a test:

Send me a test notification via Pushary saying "hello from Cursor"

Your phone should buzz within 2 seconds.

Now try human-in-the-loop:

Before you refactor this file, ask me via Pushary push notification if I want to keep backward compatibility

Your phone will show the question with Yes/No buttons. Tap your answer and the agent continues.

Human-in-the-loop guide

What your agent can do

Once connected, your agent has access to these tools:

Tool	What it does
`send_notification`	Send a push notification with optional rich context (files changed, errors, next steps)
`ask_user`	Ask a question: yes/no, multiple choice, or free text
`wait_for_answer`	Poll for your response to a question
`cancel_question`	Cancel a pending question that's no longer relevant

Plus 15 more tools for managing subscribers, campaigns, templates, and automation flows.

Full tools reference

Quickstart

Prerequisites

Create your Pushary account

Connect your AI agent

Send your first notification

What your agent can do

On this page

Quickstart

Prerequisites

Create your Pushary account

Connect your AI agent

Send your first notification

What your agent can do

On this page