Skip to content
cccskills
FreePublished on GitHub

agentmemory-mcp-tools

Helps agents choose the right agentmemory tool through MCP, a protocol for connecting agents to tools. It explains tool roles and points to parameter references for saving, retrieving, organizing, and maintaining stored knowledge.

OriginalShow the original 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.

See how to install

Good for

  • Choosing a tool to save or retrieve knowledge
  • Checking tool names and required parameters
  • Reviewing available memory management operations
  • Investigating recall results limited by a retrieval budget

Files included (3)

  • SKILL.md2.6 KB
  • REFERENCE.md10.7 KB
  • TROUBLESHOOTING.md3.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Connect agentmemory to coding agents such as Claude Code and Codex while preserving existing server settings. It guides configuration, host restarts, and checks that memory tools are available and can save and retrieve information.

  • Connecting agentmemory to a coding agent
  • Checking supported agents and connection methods
  • Investigating an incorrect configuration path
rohitg00/agentmemory29.7KUpdated Oct 19, 2026

Explain how agentmemory stores and retrieves coding agents’ memories, including its engine, search methods, memory lifecycle, ports, and web viewer. Useful for understanding the system or planning extensions to its functions.

  • Understand how agent memories are stored and retrieved
  • Plan extensions to agentmemory
  • Check memory capture in the web viewer
rohitg00/agentmemory29.7KUpdated Oct 19, 2026

Set up and troubleshoot a local agentmemory server by checking MCP connections, authentication, ports, and environment settings. Understand which optional memory features require additional configuration, model downloads, or token usage before enabling them.

  • Set up a local agentmemory connection
  • Diagnose MCP connection failures
  • Review authentication and custom ports
rohitg00/agentmemory29.7KUpdated Oct 19, 2026

Understand how agentmemory automatically records tool activity, prompts, and session boundaries through hooks, actions triggered by session events. Use it to check integration setup, investigate missing records, and distinguish capture from optional summaries and context injection.

  • Understanding automatic session recording
  • Investigating missing observations
  • Checking capture and summary settings
rohitg00/agentmemory29.7KUpdated Oct 19, 2026

Guides HTTP integration with the agentmemory server for saving and searching knowledge. It explains authentication, request conventions, and endpoint references, including how to connect systems that do not support MCP, the agent tool connection protocol.

  • Saving and searching knowledge over HTTP
  • Connecting a host that does not support MCP
  • Checking authentication and response conventions
rohitg00/agentmemory29.7KUpdated Oct 19, 2026

commit-context

FreeSummary

Trace a file, function, or line through Git history to the agent session linked to its commit. It presents recorded commit details, session summaries, and important observations to help explain the change.

  • Investigating why a particular line changed
  • Finding the agent session behind a function change
  • Checking a file's latest commit and author
rohitg00/agentmemory29.7KUpdated Oct 19, 2026

See all skills by rohitg00

Report a problem with this skill