Skip to documentation
Notify Docs

Get connected

Connect the source and the people who should receive its updates. Start with an account and device, then choose a webhook, an MCP client, or the CLI.

Choose your connection

Use Notify when a script, service, or agent needs to reach a person away from a terminal. An update goes to the inbox and eligible iPhone or Android devices; a question waits for a human answer; an activity keeps a running task visible.

Choose a webhook for an existing system that can POST JSON. Choose MCP for a compatible agent client, or the CLI for terminal workflows. Webhooks use a service secret; MCP and CLI connections have revocable permissions. Personal and Family plans are free.

Account, device, and service

Sign in to Notify with Apple or Google. Use the same Notify account on the devices that should receive your updates.
Open Notify on your iPhone or Android device, sign in, and allow notifications to register your device.
In the dashboard, add a service for one source, such as Warehouse scanner. Set its sender title, optional image, and destination URL.
Save the returned webhook URL in the sending system’s secret store. You can now send an update.

For help with your account or setup, contact info@belweave.com.

Save the service credential

The URL includes a bearer credential for this service. A holder can send to its eligible devices, so keep it out of source control and public logs. Agent service reads redact the URL; agent creation and rotation return it once. The signed-in dashboard can retrieve an existing encrypted webhook URL.

Webhook URL
https://notify.belweave.ai/hooks/whk_your_token

Rotation invalidates the previous URL. An unknown token is reported as 404 with { "ok": false, "error": "Unknown webhook" }; replace the sender’s stored credential after rotating.

Connect an MCP client

For an MCP-capable client, configure Notify as a remote Streamable HTTP server. Use the shared endpoint below, then complete the browser consent flow when the client connects.

MCP server URL
https://notify.belweave.ai/mcp

OpenCode configuration belongs in opencode.json:

json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "notify": { "type": "remote", "url": "https://notify.belweave.ai/mcp" }
  }
}

For Claude Code, use the HTTP add command below. Cursor’s configuration goes in ~/.cursor/mcp.json:

bash
claude mcp add --transport http notify https://notify.belweave.ai/mcp
json
{
  "mcpServers": {
    "notify": { "url": "https://notify.belweave.ai/mcp" }
  }
}

Set up the CLI

Download the versioned CLI bundle from Notify Tools releases. Requires Node.js 22.13 or newer; no npm package installation is needed.

Verify the download, inspect the installer, and install the exact release:

bash
curl -fLO https://github.com/Belweave/notify-tools/releases/download/v0.11.1/notify-tools-0.11.1.tar.gz
curl -fLO https://github.com/Belweave/notify-tools/releases/download/v0.11.1/SHA256SUMS
shasum -a 256 -c SHA256SUMS
mkdir notify-tools-0.11.1
tar -xzf notify-tools-0.11.1.tar.gz -C notify-tools-0.11.1
cd notify-tools-0.11.1
node install.mjs --dry-run
node install.mjs
export PATH="$HOME/.local/bin:$PATH"
notify auth login
notify --help
Run notify auth login to obtain a short device-authorization code and open Notify in your browser.
Sign in, inspect the requested scopes, and authorize the connection.
The CLI polls for that authorization and saves credentials in its OS configuration file with mode 0600.

Check your connection with notify auth status. Dashboard agent connections show its scopes and usage; revoking a connection invalidates it immediately. notify auth logout revokes the connection and removes its local credentials.

Repeat --scope to request only needed permissions. --client-name labels the connection and --expires-in controls its lifetime (default 90d). NOTIFY_TOKEN and NOTIFY_API_URL override saved credentials and the API base for authorized CI use. Keep credential values in your environment’s secret store.