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
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.
https://notify.belweave.ai/hooks/whk_your_tokenRotation 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.
https://notify.belweave.ai/mcpOpenCode configuration belongs in opencode.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:
claude mcp add --transport http notify https://notify.belweave.ai/mcp{
"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:
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 --helpnotify auth login to obtain a short device-authorization code and open Notify in your browser.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.