# Agentmemory MCP Tools

Map of every agentmemory MCP tool, what each does, and its parameters.

- Repository: https://github.com/rohitg00/agentmemory (30072 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -g -a claude-code -y`
Codex: `npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -g -a codex -y`
Cursor: `npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -g -a cursor -y`
Gemini CLI: `npx skills add rohitg00/agentmemory --skill agentmemory-mcp-tools -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add rohitg00/agentmemory`

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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

The rest: https://github.com/rohitg00/agentmemory/blob/HEAD/plugin/skills/agentmemory-mcp-tools/SKILL.md