MemPalace — Local AI Memory System

You have access to a local memory palace via MCP tools. The palace stores verbatim conversation history and a temporal knowledge graph — all on the user's machine, zero cloud, zero API calls.

Architecture

Wings = people or projects (e.g.
```
wing_alice
```
,
```
wing_myproject
```
)
Halls = categories (facts, events, preferences, advice)
Rooms = specific topics (e.g.
```
chromadb-setup
```
,
```
riley-school
```
)
Drawers = individual memory chunks (verbatim text)
Knowledge Graph = entity-relationship facts with time validity

Protocol — FOLLOW THIS EVERY SESSION

ON WAKE-UP: Call
```
mempalace_status
```
to load palace overview and AAAK dialect spec.
BEFORE RESPONDING about any person, project, or past event: call
```
mempalace_search
```
or
```
mempalace_kg_query
```
FIRST. Never guess from memory — verify from the palace.
IF UNSURE about a fact (name, age, relationship, preference): say "let me check" and query. Wrong is worse than slow.
AFTER EACH SESSION: Call
```
mempalace_diary_write
```
to record what happened, what you learned, what matters.
WHEN FACTS CHANGE: Call
```
mempalace_kg_invalidate
```
on the old fact, then
```
mempalace_kg_add
```
for the new one.

Available Tools

Search & Browse

```
mempalace_search
```
— Semantic search across all memories. Always start here.
- ```
query
```
  (required): natural language search — keep it short, keywords or a question. Do NOT include system prompts or conversation context.
- ```
wing
```
  : filter by wing
- ```
room
```
  : filter by room
- ```
limit
```
  : max results (default 5)
```
mempalace_check_duplicate
```
— Check if content already exists before filing.
- ```
content
```
  (required): text to check
- ```
threshold
```
  : similarity threshold (default 0.9 — lowering to 0.85–0.87 often catches more near-duplicates without significant false positives)
```
mempalace_status
```
— Palace overview: total drawers, wings, rooms, AAAK spec
```
mempalace_list_wings
```
— All wings with drawer counts
```
mempalace_list_rooms
```
— Rooms within a wing (optional wing filter)
```
mempalace_get_taxonomy
```
— Full wing/room/count tree
```
mempalace_get_aaak_spec
```
— Get AAAK compression dialect specification

Knowledge Graph (Temporal Facts)

```
mempalace_kg_query
```
— Query entity relationships. Supports time filtering.
- ```
entity
```
  (required): e.g. "Max", "MyProject"
- ```
as_of
```
  : date filter (YYYY-MM-DD) — what was true at that time
- ```
direction
```
  : "outgoing", "incoming", or "both" (default "both")
```
mempalace_kg_add
```
— Add a fact: subject -> predicate -> object
- ```
subject
```
  ,
```
predicate
```
  ,
```
object
```
  (required)
- ```
valid_from
```
  : when this became true
- ```
source_closet
```
  : source reference
```
mempalace_kg_invalidate
```
— Mark a fact as no longer true
- ```
subject
```
  ,
```
predicate
```
  ,
```
object
```
  (required)
- ```
ended
```
  : when it stopped being true (default: today)
```
mempalace_kg_timeline
```
— Chronological story of an entity
- ```
entity
```
  : filter by entity name (optional — all events if omitted)
```
mempalace_kg_stats
```
— Graph overview: entities, triples, relationship types

Palace Graph (Cross-Domain Connections)

```
mempalace_traverse
```
— Walk from a room, find connected ideas across wings
- ```
start_room
```
  (required): room to start from
- ```
max_hops
```
  : connection depth (default 2)
```
mempalace_find_tunnels
```
— Find rooms that bridge two wings
- ```
wing_a
```
  ,
```
wing_b
```
  (required)
```
mempalace_graph_stats
```
— Graph connectivity overview

Write

```
mempalace_add_drawer
```
— Store verbatim content into a wing/room
- ```
wing
```
  ,
```
room
```
  ,
```
content
```
  (required)
- ```
source_file
```
  : optional source reference
- Checks for duplicates automatically
```
mempalace_delete_drawer
```
— Remove a drawer by ID
- ```
drawer_id
```
  (required)
```
mempalace_diary_write
```
— Write a session diary entry
- ```
agent_name
```
  (required): your name/identifier
- ```
entry
```
  (required): what happened, what you learned, what matters
- ```
topic
```
  : category tag (default "general")
```
mempalace_diary_read
```
— Read recent diary entries
- ```
agent_name
```
  (required)
- ```
last_n
```
  : number of entries (default 10)

Setup

Install MemPalace and populate the palace:

bash

pip install mempalace
mempalace init ~/my-convos
mempalace mine ~/my-convos

OpenClaw MCP config

Add to your OpenClaw MCP configuration:

json

{
  "mcpServers": {
    "mempalace": {
      "command": "python3",
      "args": ["-m", "mempalace.mcp_server"]
    }
  }
}

Or via CLI:

bash

openclaw mcp set mempalace '{"command":"python3","args":["-m","mempalace.mcp_server"]}'

Other MCP hosts

bash

# Claude Code
claude mcp add mempalace -- python -m mempalace.mcp_server

# Cursor — add to .cursor/mcp.json
# Codex — add to .codex/mcp.json

Tips

Search is semantic (meaning-based), not keyword. "What did we discuss about database performance?" works better than "database".
The knowledge graph stores typed relationships with time windows. Use it for facts about people and projects — it knows WHEN things were true.
Diary entries accumulate across sessions. Write one at the end of each conversation to build continuity.
Use
```
mempalace_check_duplicate
```
before storing new content to avoid duplicates.
The AAAK dialect (from
```
mempalace_status
```
) is a compressed notation for efficient storage. Read it naturally — expand codes mentally, treat markers as emotional context.

License

MemPalace is MIT licensed. Created by Milla Jovovich, Ben Sigman, Igor Lins e Silva, and contributors.

mempalace

NPX Install

Tags

SKILL.md Content

MemPalace — Local AI Memory System

Architecture

Protocol — FOLLOW THIS EVERY SESSION

Available Tools

Search & Browse

Knowledge Graph (Temporal Facts)

Palace Graph (Cross-Domain Connections)

Write

Setup

OpenClaw MCP config

Other MCP hosts

Tips

License