Flags

Flags are reusable labels you can attach to any note, useful for marking things like “needs review” across categories. For simpler grouping without notifications, use Tags.

Creating a flag

On the Flags page, use Create to define a new flag with a name, an optional purpose (shown as a tooltip wherever the flag appears), and a Notify me when this flag is added checkbox for email notifications.

Attaching a flag to a note

From inside a note, use Add flag to open a menu of flags not yet on that note. You can also create a brand-new flag directly from that same menu. Attached flags appear as chips on the note, and you can remove one by hovering over its chip and clicking the “x.”

Notifications

Flags with email notifications turned on show a bell icon, both in the Flags table and wherever you pick a flag to attach. Adding that flag to a note sends you an email.

In Edit flag, you can also enable webhooks. Webhook configuration is available on Pro and Trial. Email notifications for flags are available on every plan. Every destination POSTs the same JSON, including message (the human-readable notification, same as text). The same notification fields are also nested under payload so Hermes {payload.message} or {payload.note.url} templates resolve. Grok Bot stores a URL, key, and Authorization header and POSTs that payload to api2.cursor.sh. Hermes stores a URL and HMAC secret and POSTs the same JSON to https://<instance>.agents.nousresearch.com/webhooks/<route>, signing the exact body with X-Hub-Signature-256. Slack and Discord store an incoming webhook URL only. Configure those connection settings in the Flags screen or with configure_flag_webhook when your MCP client exposes it. Supply flag_id, provider (grok_bot, slack, discord, or hermes), and enabled. For Grok Bot, supply url, key, and header together; for Slack or Discord, supply url only; for Hermes, supply url and key together and omit header. Omit the connection fields to stop or resume notifications. Disabling preserves the saved connection. Configuration does not send a test notification or create a delivery job. MCP receipts report the host and safe configuration status, not stored secrets. In Edit flag, saved webhook values appear as read-only text (keys show the first five characters, then bullets). To change them, overwrite the connection fields.

Deleting a flag

Delete a flag from its row’s menu on the Flags page. If it’s currently attached to any notes, you’ll see how many before confirming. After deleting, a snackbar with an Undo button lets you restore it for a short time.