Recall memories
recallSearch long-term memory using natural language queries. Filter by tags, types, collections, and visibility to retrieve stored information from past interactions.
Instructions
Search long-term memory. Call list_collections when scope is unclear. For GitHub/Notion synced content use collection project: (unified per project) or tags github/notion. Connect at dashboard.memxus.com/integrations. After this tool returns, show the user the pre-rendered block at the end of the tool result verbatim (user_facing_template). Do not repeat the raw context_block. Expand context: if count < total, recall/get_context with exclude_memory_ids + higher max_memories; if count === total, say no more memories without calling the server. Skills: use N → use_skill_in_chat, install N → install_skill, skip N → skip_skill.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Optional tags. A tag like project:my-app also sets collection automatically. | |
| type | No | Memory category: general, preference, fact, instruction, or conversation. Omit to include all types. | |
| limit | No | Max results. Omit for server default (10). Capped per your plan on the server. | |
| query | Yes | Natural-language search query (e.g. "Henry project stack", "user prefers dark mode"). | |
| group_id | No | UUID of a shared group. Required with visibility=shared when group_name is not set. | |
| collection | No | Scope slug (e.g. project:memxus, personal:preferences). GitHub/Notion connector syncs use project:<slug> — one collection per project. Partial names work; call list_collections when unsure. | |
| group_name | No | Exact group name (case-insensitive). Alternative to group_id for shared memories. | |
| visibility | No | Optional. Defaults to user dashboard preference (private unless include_group_memories_in_context is on). | |
| include_skills | No | When skill routing is enabled, append official skill suggestions for work intents (build/review/fix/test). Default: auto-detect from query. | |
| exclude_memory_ids | No | Memory IDs to exclude (for "Ampliar el contexto" follow-up calls). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | Number of memories returned. | |
| total | No | Total eligible memories for ranking (before LIMIT). | |
| message | Yes | Human-readable summary (same as content text). | |
| memories | Yes | Matching memories, ordered by relevance. | |
| tokens_used | No | Estimated tokens in the injected response. | |
| impact_summary | No | ||
| skills_message | No | Formatted skills block when skill routing is active. | |
| suggested_skills | No | Optional skill suggestions when skill routing is active. | |
| impact_summary_text | No | Token reuse line for the AHORRO block when ENABLE_IMPACT_SUMMARY is on. |