agentmemory-mcp-tools

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

and do not read local credential files.

Audit 0.4.1 · source sha 03d581f00d50 · 29 Oct 2026Report an issue or request a re-scan

• Publisherrohitg00 GitHub userOwner of the repository this skill is read from
• Source folderrohitg00/agentmemory/plugin/skills/agentmemory-mcp-toolsThe exact folder we audited
• LicenceApache-2.0As the repository states it
• Commit pinned for this verdict03d581f00d50A new audit runs when the source changes
• Repository statusNot archivedPushed today
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its 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.

---
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. For Pi and OMP, connect with `--with-mcp` to enable the broader workflows. Pi exposes MCP names with an `mcp__agentmemory__` prefix; OMP exposes MCP operations as `xd://mcp__agentmemory_<tool>` devices through its `write` tool.

## 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.

Excerpt, first 2,914 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

1. 2026-10-29
   ✓SAFE B 89 / 100

   first audit · source 03d581f00d50

Questions about agentmemory-mcp-tools

• github.com/rohitg00/agentmemory/tree/main/plugin/skills/agentmem — the audited source at commit 03d581f00d50 and every finding aboveObserved · 29 Oct 2026

Spotted something wrong? Report a correction · Methodology