name: memory-mcp description: > MCP Server that exposes LanceDB Pro as shared memory tools for Claude Code. Provides remember/recall/list_facts/check_duplicate/forget — enabling instant read/write access to a shared knowledge base across multiple AI agents (Claude Code, OpenClaw, Antigravity) without waiting for distillation cycles. Use when you want any agent to instantly query or store memories mid-conversation.

Memory MCP Server

Share long-term memory across AI agents via a MCP server backed by LanceDB Pro.

What This Does

Wraps LanceDB Pro as 5 MCP tools so Claude Code (and other agents) can:

• Instantly write a memory without waiting for the Stop hook + distillation cycle
• Instantly query memories written by any agent (OpenClaw, Antigravity, Claude Code)
• Deduplicate before writing to prevent knowledge base pollution

Architecture

Claude Code  ──┐
OpenClaw     ──┼──→  memory-mcp/server.py (MCP stdio)
Antigravity  ──┘              │
                              ▼
                   LanceDB Pro (local vector DB)
              ~/.openclaw/memory/lancedb-pro/
                              │
                    Jina AI Embeddings API
                (jina-embeddings-v5-text-small, 1024-dim)

Prerequisites

1. memory-lancedb-pro plugin installed in OpenClaw (provides the LanceDB Pro database and

   memories

   table)
2. Python 3 with

   lancedb

   package:

   pip3 install lancedb

3. JINA_API_KEY — get a free key at jina.ai
4. curl available on PATH

Installation

1. Copy server

cp server.py ~/.openclaw/skills/memory-mcp/server.py
chmod +x ~/.openclaw/skills/memory-mcp/server.py

2. Set environment variable

Add to your shell profile (

~/.zshrc

~/.bashrc

export JINA_API_KEY="your_jina_api_key_here"

Also add to your LaunchAgent plist if running as a background service:

<key>EnvironmentVariables</key>
<dict>
  <key>JINA_API_KEY</key>
  <string>your_jina_api_key_here</string>
</dict>

3. Register in Claude Code

Add to

~/.claude/claude.json

{
  "mcpServers": {
    "memory-mcp": {
      "command": "python3",
      "args": ["/Users/YOUR_USERNAME/.openclaw/skills/memory-mcp/server.py"],
      "env": {
        "JINA_API_KEY": "your_jina_api_key_here"
      }
    }
  }
}

Restart Claude Code after editing

claude.json

.

Tools

remember(content, tags?, agent?, importance?)

Write a memory to LanceDB. Automatically generates embedding via Jina AI.

content    — the memory text (required)
tags       — list of category tags, e.g. ["fact", "decision"]
agent      — scope identifier, e.g. "agent:claude-code" (required for correct display)
importance — 0.0–1.0, default 0.7

recall(query, top_k?, agent_filter?)

Keyword search across all memories.

query        — search string (required)
top_k        — max results, default 5
agent_filter — restrict to a specific scope, e.g. "agent:antigravity"

list_facts(agent?, tag?)

Exact-match filter list (not semantic search).

agent — filter by scope
tag   — filter by category tag

check_duplicate(content, threshold?)

Check if a similar memory already exists before writing.

content   — text to check (required)
threshold — word-overlap ratio, default 0.90

Returns

{ "is_duplicate": bool, "similar": [...] }

forget(memory_id)

Delete a memory by ID.

Scope Naming Convention

Use

agent:<id>

agent:claude-code

agent:antigravity

agent:main

global

Important: Scopes without

agent:

prefix (e.g. bare

"claude-code"

) will not appear in Agent Monitor's sidebar.

Known Pitfalls

❌ Timestamp must be milliseconds

The

timestamp

time.time()

This server uses

time.time() * 1000

❌ Never use zero vectors

Always call the Jina API for real embeddings. Zero vectors (

[0.0] * 1024

❌ Python urllib returns 403 from Jina

Use

curl

urllib

requests

Complement to

claude-code-memory

This skill works alongside (not instead of) the claude-code-memory skill:

License

Apache 2.0