@agent-memo/mcp-client

MCP client for Agent-Memo.AI — cloud-based memory management for AI agents. Enables Claude Code, Cursor, Windsurf, and other MCP-compatible tools to store and retrieve persistent memories across conversations.

Quick Start

1. Get Your API Token

1. Visit agent-memo.ai
2. Register and login
3. Copy your API token from the Dashboard

2. Configure MCP Server

Add .mcp.json to your project root (or ~/.claude/.mcp.json for global):

{
  "mcpServers": {
    "agent-memo": {
      "command": "npx",
      "args": ["-y", "@agent-memo/mcp-client"],
      "env": {
        "AGENTMEMO_TOKEN": "your-token-here"
      }
    }
  }
}

• Project is auto-detected from git remote or directory name
• Set AGENTMEMO_PROJECT in env to override (e.g. "AGENTMEMO_PROJECT": "my-project")

3. (Optional) Auto-save Hooks

Add to ~/.claude/settings.json to enable auto-save across all projects:

{
  "hooks": {
    "Stop": [{"matcher": "*", "hooks": [{"type": "command", "command": "npx -y @agent-memo/mcp-client --hook save", "timeout": 30}]}],
    "PreCompact": [{"hooks": [{"type": "command", "command": "npx -y @agent-memo/mcp-client --hook precompact", "timeout": 30}]}]
  }
}

• Stop hook — auto-saves memories every 15 messages
• PreCompact hook — forces memory save before context compression

VSCode Extension (if npx doesn't work)

Install globally first, then use the direct node path:

npm install -g @agent-memo/mcp-client

{
  "mcpServers": {
    "agent-memo": {
      "command": "node",
      "args": ["<path-to-global-node-modules>/@agent-memo/mcp-client/dist/index.js"],
      "env": {
        "AGENTMEMO_TOKEN": "your-token-here"
      }
    }
  }
}

Find your global install path: npm root -g

Available Tools (14)

Memory (7)

| Tool | Description | |------|-------------| | memory_store | Store a new memory with type, importance, topic, and tags | | memory_recall | Semantic search with topic/type/importance filtering | | memory_overview | Get high-importance memories (quick overview) | | memory_expand | Expand a memory to see child memories for detail | | memory_update | Update content, topic, importance, or tags | | memory_delete | Delete a memory and all its children | | memory_stats | Get statistics (total, by type, by topic) |

Discovery (2)

| Tool | Description | |------|-------------| | memory_list_topics | List all topics with memory counts | | memory_check_duplicate | Check for near-duplicates before storing |

Knowledge Graph (5)

| Tool | Description | |------|-------------| | kg_add | Add a fact (subject → predicate → object) with temporal validity | | kg_query | Query all relationships for an entity | | kg_invalidate | Mark a fact as ended (preserved for history) | | kg_timeline | Get chronological timeline for an entity | | kg_stats | Get KG statistics (entities, facts, top entities) |

Key Features

• Topic-based filtering — Organize memories by topic for +34% recall accuracy
• Importance levels (1-4) — Critical memories surface first
• Temporal validity — Facts have valid_from/valid_to windows
• Knowledge Graph — Entity-relationship tracking with time-aware queries
• Duplicate detection — Semantic similarity check before storing
• Project isolation — Memories auto-scoped to current project
• Multi-scope — Personal, Project, and Team memory scopes

Memory Types

| Type | Use For | |------|---------| | user | User preferences, profile, work style | | project | Decisions, architecture, context | | feedback | Corrections, what to avoid/repeat | | reference | Links, docs, external resources | | conversation | Session highlights, action items |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AGENTMEMO_TOKEN | Yes | JWT token from agent-memo.ai dashboard | | AGENTMEMO_API_URL | No | API URL (default: https://api.agent-memo.ai) | | AGENTMEMO_PROJECT | No | Override auto-detected project slug |

How It Works

1. Project auto-detection — Detects your project from git remote URL or directory name
2. Memories auto-scoped — memory_store defaults to project scope
3. Search across scopes — memory_recall searches both project and personal memories
4. Overview loading — memory_overview returns high-importance memories for conversation startup

Support

• Website: agent-memo.ai
• Email: [email protected]

License

Proprietary. See agent-memo.ai/terms for terms of service.