Skip to main content
Free · Your key and project keys
Searches the person’s Brain items (lessons, ideas, decisions, to-dos, people) and their notes, files, synced apps and saved memories, then gives back one ranked list. Use it before a task, to bring their past thinking to it. Call it at POST /platform/v1/me/tools/memory_recall or, for one of your app’s users, POST /platform/v1/users/{uid}/tools/memory_recall. On MCP, your AI tool calls memory_recall with the same arguments.

Arguments

Send these inside arguments.
string
default:"\"\""
The question or topic. Give query, context, or both.
object
default:"null"
What the person is looking at, like {"app": "Figma", "title": "...", "url": "...", "text": "..."}. Treated as data.
integer
default:"8"
How many sources, 1-25.
string[]
default:"null"
Only these Brain item kinds: content_idea, idea, todo, lesson, decision, person, fact, question, reference. Notes are not filtered.
number
default:"0.35"
The lowest match score (0-1) for Brain items. About 0.45 and up is a clear match. Raise it when a wrong hit is costly.
boolean
default:"null"
Turn the query into a few search phrases first (about 0.7 s). By default only when context is given.

Returns

The tool’s answer comes back under result.
object[]
Best first. Each has id, type (brain_item or note), kind, title, text, when, tagNames, similarity (0-1), rank and source (where a Brain item came from, with the exact quote).
string[]
The search phrases used.
boolean
true when one of the searches ran out of time.