mm_recall

Recall the most semantically-similar memory notes for a query from local semantic memory. Embeds the query with a bundled local model (offline, private — data never leaves the machine) and returns the top-k nearest stored notes under .mm/index/amem/, each with a cosine score and metadata (summary, tags, keywords, links, source). Optionally filter by source/type, tags, or embedding model. Returns an empty result when nothing has been remembered yet. Fail-soft: if the model or store is unavailable it returns an error result without breaking other tools.

At a Glance

• Category: Plugin Management
• Source: Built-in
• Required parameters: 2
• Total parameters: 6

Parameters

Parameter	Type	Required	Description
project_path	string	Yes	Absolute path to the project root (directory containing .mm)
query	string	Yes	The query text to embed and match against stored memory notes
k	number	No	Maximum number of nearest notes to return (post-filter). Default: 5.
source	string | array of string	No	Restrict to notes from this source/type — a single value or a list (OR). E.g. “spec” | “session” | “note” | “issue”.
tags	array of string	No	Restrict to notes carrying at least one of these tags (OR within the field).
model	string	No	Restrict to notes embedded with this exact model id.

Example

{
  "tool": "mm_recall",
  "arguments": {
    "project_path": "/Users/you/projects/my-app",
    "query": "search query",
    "k": 1,
    "source": "example-source"
  }
}

Related Tools

• mm_list_plugins - [DEPRECATED — use mm_list with entity=plugin] List all loaded plugins with th…
• mm_get_plugin_info - [DEPRECATED — use mm_get with entity=plugin] Get detailed information about a…
• mm_push_team_checkin - Push a team check-in to the cloud. Scans local specs and features, captures c…
• mm_fetch_team_checkins - Fetch all team members’ check-ins from the cloud. Returns display names, bran…
• mm_claim_spec - Claim a spec from a teammate. Records the claim in the cloud (first-claim-win…