MCP Integration

MemPalace provides 34 tools through the Model Context Protocol (MCP), giving any MCP-compatible AI full read/write access to your palace.

Setup

Setup Helper

MemPalace includes a setup helper that prints the exact configuration commands for your environment:

mempalace mcp

Manual Connection

claude mcp add mempalace -- python -m mempalace.mcp_server
codex mcp add mempalace -- python -m mempalace.mcp_server

With Custom Palace Path

claude mcp add mempalace -- python -m mempalace.mcp_server --palace /path/to/palace
codex mcp add mempalace -- python -m mempalace.mcp_server --palace /path/to/palace

Now your AI has all 34 tools available. Ask it anything:

"What did we decide about auth last month?"

Claude calls mempalace_search automatically, gets verbatim results, and answers you.

Compatible Tools

MemPalace works with any tool that supports MCP:

• Claude Code — native via plugin or manual MCP
• Codex CLI — native via bundled Codex plugin or manual MCP
• OpenClaw — via official skill, see OpenClaw Skill
• ChatGPT — via MCP bridge
• Cursor — native MCP support
• Gemini CLI — see Gemini CLI guide

Memory Protocol

When the AI first calls mempalace_status, it receives the Memory Protocol — a behavior guide that teaches it to:

1. On wake-up: Call mempalace_status to load the palace overview
2. Before responding about any person, project, or past event: search first, never guess
3. If unsure: Say "let me check" and query the palace
4. After each session: Write diary entries to record what happened
5. When facts change: Invalidate old facts, add new ones

This protocol is what turns storage into memory — the AI knows to verify before speaking.

Tool Overview

Palace (read)

Tool	What
mempalace_status	Palace overview + AAAK spec + memory protocol
mempalace_list_wings	Wings with counts
mempalace_list_rooms	Rooms within a wing
mempalace_get_taxonomy	Full wing → room → count tree
mempalace_search	Semantic search with wing/room filters
mempalace_check_duplicate	Check before filing
mempalace_get_aaak_spec	AAAK dialect reference

Drawers (read)

Tool	What
mempalace_get_drawer	Fetch a single drawer by ID
mempalace_list_drawers	List drawers with pagination

Palace (write)

Tool	What
mempalace_add_drawer	File verbatim content
mempalace_update_drawer	Update drawer content or metadata
mempalace_delete_drawer	Remove by ID

Knowledge Graph

Tool	What
mempalace_kg_query	Entity relationships with time filtering
mempalace_kg_add	Add facts
mempalace_kg_invalidate	Mark facts as ended
mempalace_kg_timeline	Chronological entity story
mempalace_kg_stats	Graph overview

Navigation

Tool	What
mempalace_traverse	Walk the graph from a room across wings
mempalace_find_tunnels	Find rooms bridging two wings
mempalace_graph_stats	Graph connectivity overview

Tunnels

Tool	What
mempalace_create_tunnel	Create an explicit cross-wing tunnel
mempalace_list_tunnels	List all explicit tunnels
mempalace_delete_tunnel	Delete an explicit tunnel
mempalace_follow_tunnels	Follow tunnels out from a room

Agent Diary

Tool	What
mempalace_diary_write	Write AAAK diary entry
mempalace_diary_read	Read recent diary entries

System

Tool	What
mempalace_hook_settings	Get or set hook behavior
mempalace_memories_filed_away	Check whether the last checkpoint was saved
mempalace_reconnect	Force reconnect to the database

For detailed schemas and parameters, see MCP Tools Reference.