MemPalace MCP Server: Setup for Claude Code, Cursor and Other Apps

• Searches your saved memories from past sessions

  Searches memories from past sessions and returns the matching saved entries. It is not for the current conversation.

  Try: “What did we decide about the GraphQL schema last month?”

  Read · mempalace_search

• Shows an overview of your memory store

  Shows how many entries the palace holds and how many wings and rooms it has. The agent calls it when a session starts.

  Try: “Give me an overview of my memory palace.”

  Read · mempalace_status

• Lists the top-level groups in your memory

  Lists wings (people and projects) with entry counts.

  Try: “Which wings do I have?”

  Read · mempalace_list_wings

• Lists the topics inside a wing

  Lists rooms (topics) in a wing, or all rooms if you name no wing.

  Try: “What topics are in my billing project wing?”

  Read · mempalace_list_rooms

• Shows the full tree of wings, rooms and entries

  Returns wings, rooms and the count of entries in each.

  Try: “Show me the full structure of my memory.”

  Read · mempalace_get_taxonomy

• Fetches the compressed memory format spec

  Returns the AAAK spec, the compressed format MemPalace uses for diary entries. Needed only to read or write AAAK.

  Try: “Get the AAAK format spec.”

  Read · mempalace_get_aaak_spec

• Opens one saved entry

  Fetches one drawer (a saved entry) by ID, with full content and details.

  Try: “Open drawer 123.”

  Read · mempalace_get_drawer

• Opens many saved entries at once

  Fetches up to 500 drawers by ID in one call.

  Try: “Open these five drawers.”

  Read · mempalace_get_drawers

• Lists saved entries with filters

  Lists drawers with paging, filtered by wing, room or date, with short previews.

  Try: “List what I saved to the billing wing this week.”

  Read · mempalace_list_drawers

• Checks whether something is already saved

  Checks whether content already exists in the palace before it is filed.

  Try: “Is this note already in my memory?”

  Read · mempalace_check_duplicate

• Saves text to your memory word for word

  Files the content as it is into the palace after checking for duplicates.

  Try: “Save this design decision to the billing wing.”

  Write · mempalace_add_drawer

• Saves a whole session in one step

  Skips duplicates, files the rest as drawers, then writes one diary entry, all in a single call.

  Try: “Checkpoint this session.”

  Write · mempalace_checkpoint

• Edits a saved entry

  Changes a drawer's content or its wing and room. The replaced text is kept in the revisions file until the drawer is deleted.

  Try: “Move this drawer to the infra wing.”

  Write · mempalace_update_drawer

• Deletes a saved entry for good

  Deletes a drawer by ID. The README text calls it irreversible and removes earlier revisions too.

  Try: “Delete drawer 123.”

  Delete · mempalace_delete_drawer

• Deletes many saved entries for good

  Deletes many drawers by ID in one call, up to 500. Irreversible.

  Try: “Delete these ten drawers.”

  Delete · mempalace_delete_drawers

• Deletes everything mined from one file

  Bulk-deletes every drawer mined from one source file. It shows a dry-run count by default, and a confirmed run is irreversible.

  Try: “Delete every drawer mined from benchmark.txt.”

  Delete · mempalace_delete_by_source

• Cleans out entries whose source files are gone

  Prunes drawers whose source files are gitignored, deleted or moved. It reports a dry run by default and deletes only when told to apply.

  Try: “Show which entries point to deleted files.”

  Delete · mempalace_sync

• Reads a folder or chat export into your memory

  Ingests a directory of code and docs, a chat transcript file, or office documents into the palace and returns a summary.

  Try: “Mine ~/projects/billing into my palace.”

  Write · mempalace_mine

• Reloads the memory database

  Forces a reconnect to the palace database after outside scripts changed it.

  Try: “Reconnect to my palace.”

  Read · mempalace_reconnect

• Shows or changes auto-save behaviour

  Gets or sets how save hooks behave, including silent save and desktop notifications.

  Try: “Show my auto-save settings.”

  Write · mempalace_hook_settings

• Checks that a recent save went through

  Checks whether a recent palace checkpoint was saved and returns a message count and time.

  Try: “Did my last session get saved?”

  Read · mempalace_memories_filed_away

• Looks up facts about a person or thing

  Queries the knowledge graph for an entity's relationships, with the dates each fact was true.

  Try: “What do you know about Alice, as of March?”

  Read · mempalace_kg_query

• Records a fact with dates

  Adds a subject, predicate and object fact to the knowledge graph, with an optional time window.

  Try: “Record that Max started Year 7 on 2026-09-01.”

  Write · mempalace_kg_add

• Marks a fact as no longer true

  Marks a fact as ended, such as a job that ended.

  Try: “Mark that Alice no longer works at Acme.”

  Write · mempalace_kg_invalidate

• Replaces a fact with its newer version

  Replaces a fact with its successor at a shared date, so a point-in-time query returns only the new value.

  Try: “Alice's employer changed to Globex today.”

  Write · mempalace_kg_supersede

• Shows the story of a person or thing in order

  Shows facts in time order for one entity or for everything, with paging.

  Try: “Give me a timeline for Project Falcon.”

  Read · mempalace_kg_timeline

• Shows knowledge graph totals

  Shows counts of entities, facts, current and expired facts and relationship types.

  Try: “How big is my knowledge graph?”

  Read · mempalace_kg_stats

• Follows connections from one topic

  Walks the palace graph from a room and shows connected ideas in other wings.

  Try: “What connects to my chromadb-setup room?”

  Read · mempalace_traverse

• Finds topics that link two wings

  Finds rooms that bridge two wings.

  Try: “What topics connect my code and team wings?”

  Read · mempalace_find_tunnels

• Shows where a room's links lead

  Follows tunnels from a room to connected rooms in other wings, with previews.

  Try: “Follow the links from my API design room.”

  Read · mempalace_follow_tunnels

• Shows memory graph totals

  Shows total rooms, tunnel connections and edges between wings.

  Try: “How connected is my palace?”

  Read · mempalace_graph_stats

• Links two topics across wings

  Creates a tunnel linking two palace locations that relate to each other.

  Try: “Link the API design room to the database schema room.”

  Write · mempalace_create_tunnel

• Lists links between wings

  Lists explicit cross-wing tunnels, optionally for one wing.

  Try: “List the tunnels for my code wing.”

  Read · mempalace_list_tunnels

• Removes a link between wings

  Deletes an explicit tunnel by ID.

  Try: “Delete tunnel 7.”

  Delete · mempalace_delete_tunnel

• Lists links inside a wing

  Lists within-wing hallway records built at mining time, strongest first.

  Try: “Show the strongest links inside my code wing.”

  Read · mempalace_list_hallways

• Removes a link inside a wing

  Deletes a hallway record by ID.

  Try: “Delete hallway 12.”

  Delete · mempalace_delete_hallway

• Shows other palaces this one syncs with

  Returns this palace's identity and the status of each configured peer.

  Try: “Which peers does my palace sync with?”

  Read · mempalace_mesh_peers

• Writes an agent's personal diary entry

  Writes to the agent's own diary in the compressed AAAK format.

  Try: “Write today's work to your diary.”

  Write · mempalace_diary_write

• Reads an agent's recent diary entries

  Reads the agent's recent diary entries.

  Try: “What did your diary say about last session?”

  Read · mempalace_diary_read

• Creates a task for another agent

  Creates a complete task request for another agent and returns a short handoff line. The caller must preview the task with you first.

  Try: “Hand this refactor to the reviewer agent.”

  Write · mempalace_task_create

• Posts a message to the agents' shared log

  Appends an immutable coordination event for delegating work, replying or announcing a patch.

  Try: “Announce that the patch is ready.”

  Write · mempalace_event_append

• Lists messages in the agents' shared log

  Lists coordination events with filters, newest first by default.

  Try: “Show recent events addressed to me.”

  Read · mempalace_event_list

• Waits for a reply from another agent

  Blocks until a matching event appears or the timeout (default 60 seconds, max 5 minutes) expires.

  Try: “Wait for the reviewer's reply.”

  Read · mempalace_event_wait

• Acknowledges a log message

  Appends an acknowledgement routed back to the original writer.

  Try: “Acknowledge the task request.”

  Write · mempalace_event_ack

• Stores a patch, file or log for another agent

  Stores exact text content, up to 4 MiB, for agent handoffs and returns an ID and checksum.

  Try: “Store this diff for the reviewer.”

  Write · mempalace_artifact_put

• Fetches a stored handoff artifact

  Fetches an artifact by ID with a checksum to verify it.

  Try: “Get artifact 9.”

  Read · mempalace_artifact_get

• Stores a patch and announces it in one step

  Stores a patch artifact and appends its ready event in one call.

  Try: “Submit this patch to the reviewer.”

  Write · mempalace_patch_submit

Watch out for

• It can delete saved memories for good

  Delete tools remove entries and their earlier revisions, and the schema calls this irreversible. Back up the palace folder before you let an agent clean it up. github.com

• It stores your chats word for word

  The palace can hold private conversations, code and notes in plain text on disk. Keep it out of shared folders and backups you do not trust. github.com

• It reads any folder you point it at

  The mine tool ingests a directory or chat file into the palace. With Docker, it sees only the folders you mount. github.com

• First run downloads an embedding model

  The README says the first command that needs embeddings downloads about 80 MB and needs network access, so a first call can look hung. github.com

• No read-only mode is documented

  The README does not describe a switch that limits the server to read tools. github.com

Security advisories