# agentmemory-mcp-tools

Lists every agentmemory MCP tool with what it does and its parameters, so your agent picks the right memory tool.

Skill by Rohit Ghumare. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Fail
- Socket: Pass
- Snyk: Pass

Installs: 10848. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/rohitg00/agentmemory/agentmemory-mcp-tools)

## Source

[Open the source](https://github.com/rohitg00/agentmemory/tree/HEAD/plugin/skills/agentmemory-mcp-tools). Checked 2026-10-24. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: agentmemory-mcp-tools
description: Map of every agentmemory MCP tool, what each does, and its parameters. Use when choosing which memory tool to call, when a tool name or argument is unclear, or when answering what agentmemory can do via MCP.
user-invocable: false
---

This skill indexes agentmemory's MCP tools. Use the connected server's tool inventory and schemas; a native memory provider may expose a smaller set under different names. Hermes and OpenClaw skills that need the full surface require a separate MCP connection to the running daemon.

## Quick start

Save then recall:

1. `memory_save` with `content` (the insight), `concepts` (comma-separated keywords), `files` (comma-separated paths).
2. `memory_smart_search` with `query`, `limit`, and `targetLayer: "memory"` to retrieve saved knowledge later. Omit `targetLayer` to also search captured observations. This runs hybrid BM25 plus vector plus graph-expanded search.

## Tool families

- Capture: `memory_save`, `memory_compress_file`. Automatic observations use native hooks or `POST /agentmemory/observe`, not an MCP observation tool.
- Retrieve: `memory_smart_search`, `memory_recall`, `memory_file_history`, `memory_timeline`, `memory_vision_search`.
- Sessions and commits: `memory_sessions`, `memory_commits`, `memory_commit_lookup`.
- Knowledge and graph: `memory_lesson_save`, `memory_lesson_recall`, `memory_graph_query`, `memory_relations`, `memory_patterns`, `memory_crystallize`.
- Structured slots: `memory_slot_create`, `memory_slot_append`, `memory_slot_get`, `memory_slot_list`, `memory_slot_replace`, `memory_slot_delete`.
- Governance and health: `memory_governance_delete`, `memory_audit`, `memory_verify`, `memory_heal`, `memory_diagnose`.

## Workflow

1. Pick the narrowest tool for the task. Prefer `memory_smart_search` for open recall, `memory_recall` when you already have a focused query, `memory_sessions` for session listings.
2. Look up exact parameter names and which are required in REFERENCE.md before calling.
3. Pass only documented fields. REST handlers whitelist fields and drop unknown ones.
4. For budgeted `memory_recall`, distinguish `matched_count: 0` from
   `excluded_by_budget > 0`. Expand clipped or omitted IDs with
   `memory_smart_search` and `expandIds`, preserving the same scope filters.

## See also

- agentmemory-rest-api for the HTTP equivalents.
- agentmemory-config for tool-visibility and feature flags.
- The user-invocable action skills (remember, recall, recap, handoff, forget) wrap the most common tools.

## Reference

Full tool table with parameters and the core-set marking lives in REFERENCE.md, generated from source so it never drifts.
````

- Previous: [agentmemory-config](https://syn4pse.dev/terminal/agentmemory-config.md)
- Next: [agentmemory-rest-api](https://syn4pse.dev/terminal/agentmemory-rest-api.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
