search_memory
Keyword search over notes. A path limits it to one note.
Looks for words in global notes, session notes or both and returns short excerpts. With a path it returns the whole note.
- Tool name
- search_memory
- Group
- Memory
- Risk
- none
- Needs approval
- never
- Approval rule
- Read only.
- Allowed in scheduled jobs
- Yes
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| query | string | Yes | Words to look for. | ||
| scope | string | No | both | Where the note lives: global (all chats) or session (this chat). | One of: global, session, both. |
| path | string | No | Path relative to the project, such as vault/note.md. |
Returns
Matching excerpts, about 25 lines each.
Example (made up for this page)
{
"query": "demo"
}global/deploy-notes.md: ...port 8080 is used by the demo...Side effects
- none
How it can fail
| When | What the agent sees |
|---|---|
| The path leaves the memory folder | The path is rejected |
See also:Memory tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.