Hark

One inbox for AI agents, scripts and webhooks. Send a notification with one HTTP call or one MCP tool call, and receive it on Android, macOS and the web, with live-updating progress, action buttons, inline replies and sync across devices.

正體中文說明 · Run your own instance · Protocol

• 🤖 MCP server URL: give Claude Code, Codex or any MCP client send_notification, update_notification, ask, wait_for_response and more. Target one device (devices: ["macbook"]) or all of them.

• 🪝 Webhooks: paste a URL into Home Assistant, Alertmanager, Grafana, AWS SNS, GitHub Actions, cron or curl.

• 🔄 Live notifications that update in place (progress, status), resolve everywhere, and record your answers.

• 💬 Two-way: agents ask, you tap a button or type a reply on any device, and the agent gets the answer.

• 🧩 Templates: one platform-neutral card schema, rendered natively everywhere.

Free and open source (MIT).

Screenshots

Related MCP server: agent-notify

Get it

Then pair the device: on the web, Devices → Pair a device, and enter the code in the app. Releases are built and signed by GitHub Actions (release.yml); each one includes SHA256SUMS.txt.

Quick start

1. Run an instance (docs/setup.md) and sign in at https://<your-host>.

2. On Connect, create an MCP server URL for your agent or a webhook for everything else.

3. Send something:

# Webhook
curl -d "Backup finished" "https://<your-host>/hook/<webhook-token>?title=Backup&severity=success"

# Claude Code
claude mcp add --transport http hark https://<your-host>/mcp/<mcp-token>

https://<your-host> is the deployment's PUBLIC_URL. This repository uses hark.app as a placeholder; replace it in apps/server/wrangler.jsonc (PUBLIC_URL, VAPID_SUBJECT, routes) before deploying, and optionally as the default server URL in apps/android/app/build.gradle.kts (-PharkServerUrl=…) and apps/apple/Sources/HarkKit/Support/Pairing.swift.

Docs

Repository

Develop

pnpm install
pnpm dev          # wrangler dev + vite
pnpm test
pnpm android:build
pnpm macos:build

Releasing: git tag v0.2.0 && git push origin v0.2.0 builds the signed APK and the universal macOS app and publishes them on GitHub Releases.

Notes for self-hosters

• Sign-in is a shared password by default (AUTH_MODE=password): set AUTH_PASSWORD_HASH with pnpm --filter @hark/server hash-password '<password>'. Switch to google or both to keep Google sign-in.

• Firebase is optional. No apps/android/app/google-services.json is committed, so assembleDebug builds an app that uses the WebSocket transport. Create your own Firebase project (package name app.hark.android), drop its google-services.json in, and set the server's FCM_SERVICE_ACCOUNT_JSON from the same project to enable FCM.

• Renamed from Oyee. Hark is a rebrand of that MIT-licensed project: package names (@hark/*), Durable Object headers (X-Hark-*), token prefixes (hark_wh_, hark_mcp_, hark_dev_), the hark_session cookie and the hark:// URL scheme all use the new name. Devices paired with an older build need to be paired again, and a renamed Worker starts without the old one's secrets and D1 data.