Skip to main content
Free · Your key and project keys
Searches for the words exactly as written: one search, no planning and no reading, so it is fast and free. Search again with other words if the first try misses. Read one result in full with notes_read. Call it at POST /platform/v1/me/tools/notes_search or, for one of your app’s users, POST /platform/v1/users/{uid}/tools/notes_search. On MCP, your AI tool calls notes_search with the same arguments.

Arguments

Send these inside arguments.
string
required
What to search for.
object
default:"null"
All optional: max_results (1-60, default 14), exclude_ids (ids to leave out), include_chatter (mail, chat and calendar too; default true), apps (only results from these connected apps, like ["gmail", "slack"]).

Returns

The tool’s answer comes back under result.
object[]
Best first. Each has id, title, where, passages, score, source, type, date and via.
string[]
The searches that ran.
boolean
true when the search ran out of time.