AI Whisper Voice Note Taker

Fetch one Whisprnotes note by ID with everything the app knows about it: complete text, tags, timestamps, word count, audio clip details (duration and when it was transcribed), and whether the note has an active public share link. Use this after search returns a matching note. The ID should be a value returned by search, such as note:123.

fetch

List the authenticated user's tags with the number of notes on each. Use this to answer questions like "what topics do I have notes on?" or to discover valid tag names for search's tags filter.

list_tags

Search the authenticated user's Whisprnotes notes. Use this when the user asks about information that may be stored in their notes, or wants their notes used in the current task. Query should be ONE short natural-language phrase lifted from the user's request (e.g. "what to charge for the app"). The search is semantic; do not append keyword variants or synonyms — that hurts ranking. Pass an empty query string ("") to list the user's most recent notes (e.g. for "list all my notes"). The response's presentation field says what happened. "receipt": the match was clear-cut — each likely result carries its full note text in content; use that text to continue the user's task directly and do not enumerate the notes (the widget already confirms them). "refine": the match was ambiguous — the widget shows a list the user can narrow; reply with at most one short sentence. Optional filters: tags with tags_match="all" (default; note must have every listed tag) or tags_match="any" (note must have at least one). For "notes tagged A, B, or C" make ONE call with all the tags and tags_match="any" — never one call per tag, which shows the same note in several result widgets. Tag names are case-insensitive; requested names that don't exist come back in the response's unmatched_tags (with tags_match="all" any unknown name means zero results — check list_tags for the real names, e.g. "anecdotes" not "anecdote"). created_after / created_before take ISO dates like 2026-07-01 (created_after inclusive, created_before exclusive). untagged=true restricts to notes carrying no tags at all — use it for "notes I haven't organized/filed/tagged". It cannot be combined with tags; passing both returns zero results. Pagination: limit (max 50) and offset; total_count in the response is the number of matches before pagination. Call fetch with a result id (e.g. note:123) to retrieve one full note.

search