agentmemory-mcp-tools — Claude Code skill: what it does & install
Index of every agentmemory MCP tool with its parameters and workflows. Helps agents pick the right memory tool and format valid arguments.
npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -a claude-codeWhat agentmemory-mcp-tools does
This skill acts as a reference index for the agentmemory MCP server. It maps available tools across specific families: content capture with memory_save, hybrid search via memory_smart_search, graph relationships, session histories, and structured slot operations. Having this map prevents the model from hallucinating tool names or guessing arguments.
Running skills like Hermes or OpenClaw that require the complete toolset demands an active MCP connection to the running daemon. Server endpoints enforce a strict parameter whitelist, dropping any unknown fields upon arrival. You must consult REFERENCE.md for exact required fields rather than inventing parameters on the fly.
What it helps with
- Select the right agentmemory MCP tool for saving or recalling knowledge
- Prevent API errors caused by undeclared fields dropped by server whitelists
- Execute hybrid recall combining BM25, vector search, and graph expansion
- Inspect session histories and verify memory store integrity with audit tools
Example prompts for the agent
- Use agentmemory to run a memory_smart_search for our authentication refactor notes
- Show the required parameters for memory_slot_create from the agentmemory schema
- Run memory_audit to verify memory health and identify missing links
How to install agentmemory-mcp-tools
1Skills CLI (Vercel)
npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -a claude-code2Manually: put the files in place
~/.claude/skills/agentmemory-mcp-tools/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agentmemory-mcp-tools/
1Skills CLI (Vercel)
npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -a codex2Manually: put the files in place
.agents/skills/agentmemory-mcp-tools/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -a cursor2Manually: put the files in place
.cursor/skills/agentmemory-mcp-tools/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rohitg00/agentmemory agentmemory-mcp-tools2Manually: put the files in place
.github/skills/agentmemory-mcp-tools/SKILL.md1Skills CLI (Vercel)
npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -a gemini-cli2Platform CLI
gemini skills install https://github.com/rohitg00/agentmemory --path plugin/skills/agentmemory-mcp-toolsManually: put the files in place
.devin/skills/agentmemory-mcp-tools/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set11
The whole set →Similar
Questions about agentmemory-mcp-tools
How do I install agentmemory-mcp-tools in Claude Code?
Run npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -a claude-code in your terminal. This writes the skill definition to ~/.claude/skills/agentmemory-mcp-tools/SKILL.md.
What does agentmemory-mcp-tools do?
It provides an index of all agentmemory MCP tools, categorizing them into capture, retrieval, knowledge graph, structured slots, and governance. This ensures AI agents use documented methods with exact parameters.
Why did my agentmemory tool call fail to send extra fields?
The server REST handlers enforce a strict whitelist and silently drop undocumented fields. You must supply only parameters defined in REFERENCE.md.
Source text
SKILL.md · Apache-2.0
--- 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.
© rohitg00 · Apache-2.0 · rohitg00/agentmemory