Skip to main content

​
Description

search_memory finds memories that may help the assistant answer, code, plan, or make a decision. Use full natural-language questions for best results.

​
Parameters

ParameterTypeRequiredDefaultDescription
querystringYes-Natural language description of what to find. Full sentences produce best results.
limitnumberNo5Number of results to return. Use higher values for broad topics.
categorystringNoallFilter to preference, fact, decision, or context.
projectstringNoallFilter to a specific known project.
thresholdnumberNo0.6Search strictness. Higher values return broader matches.

​
Example

search_memory({
  query: "What package manager does the user prefer?",
  project: "memcontext"
})

​
Response

{
  "found": 1,
  "memories": [
    {
      "id": "a1b2c3d4-...",
      "content": "User prefers pnpm for JavaScript projects.",
      "category": "preference",
      "relevance": 0.92,
      "createdAt": "2026-04-11T12:00:00.000Z"
    }
  ]
}
Each result includes a relevance score from 0 to 1.

​
Query Guidelines

  • Ask a complete question.
  • Include the project name when it matters.
  • Use category if you only need one type of memory.
  • Increase limit when preparing a larger answer.
Good: 
What package manager does the user prefer?
Less effective: 
package manager
MCP tools intentionally do not expose scope. Use the REST API or TypeScript SDK when your app needs per-user or per-tenant isolation.