Memorix MCP Server: Setup for Claude, Cursor and Other Apps

• Builds a short brief for the task you are about to start

  Assembles a compact brief with start-here files, memories tied to the code, warnings about stale notes and ways to verify. It can refresh the local code index first.

  Try: “Get the project brief before we start on the login bug.”

  Write · memorix_project_context

• Searches what past sessions saved about this project

  Returns a short index of matching memories from any earlier session or agent, with filters for type, dates and status. It searches the current project unless you ask for all.

  Try: “Search project memory for how we handled rate limiting.”

  Read · memorix_search

• Opens full notes found by a search

  Fetches the full text of memories you pick by reference, including where each came from and what it links to.

  Try: “Open the full notes for the two most relevant results.”

  Read · memorix_detail

• Saves a decision, fix or gotcha for next time

  Stores a note in the project's local memory, classified as a decision, fix, gotcha, change, discovery or similar, and indexes it for search.

  Try: “Remember that we chose SQLite over Postgres because of offline use.”

  Write · memorix_store

• Marks old notes as done or archived

  Marks memories as resolved or archived so they stop appearing in default searches. They can still be found with the all filter.

  Try: “Mark the memory about the fixed login bug as resolved.”

  Write · memorix_resolve

• Builds a ready-to-use context bundle for a task

  Combines relevant memories, code facts, freshness warnings, suggested files to read and verification hints into one bundle. Use it only to go beyond the project brief.

  Try: “Build a context pack for refactoring the billing module, because the brief missed it.”

  Read · memorix_context_pack

• Shows whether the code index is ready

  Reports the state of the local code memory index for the current project and any external code-graph provider.

  Try: “Is the code index up to date?”

  Read · memorix_codegraph_status

• Starts a work session and binds the project

  Opens a new session, closes any previous one and returns a short card with the latest handoff. In a client that doesn't start in your repo, you pass the project folder here.

  Try: “Start a session for the project in /Users/me/code/shop.”

  Write · memorix_session_start

• Imports and manages images, PDFs and audio for memory

  Copies a file you name into Memorix's local media library, lists or shows assets, extracts PDF text and can attach an asset to a memory. Image and video generation stay off unless you enable them.

  Try: “Import docs/architecture.png and attach it to the design notes.”

  Write · memorix_media

Watch out for

• It saves notes about your work, which later chats read

  memorix_store and memorix_resolve write to the local memory, and other assistants on the same project read it back. Review what is stored if it could hold secrets. github.com

• The setup command installs hooks and rewrites guidance files

  memorix setup writes `memorix serve --mode lite` (21 tools) into the app's config and adds hooks that run `memorix hook` on prompts, tool calls, file edits and session end (for Claude Code and Codex: SessionStart, UserPromptSubmit, PostToolUse, PreCompact, Stop), plus guidance files such as CLAUDE.md and AGENTS.md. The events differ per app. Use --noHooks to skip the hooks, and preview removal with memorix uninstall --dry-run. github.com

• Opening a project can build a local code index

  memorix_project_context refreshes the Code Memory index when it is missing or stale, which writes snapshots to disk. Large repos take time. github.com

• Importing media copies your files

  memorix_media copies a file you name into a local media library outside the Git worktree. Image and video generation are off unless MEMORIX_MCP_MEDIA_GENERATION=1 is set. github.com

• Larger tool sets add delete tools

  Setting MEMORIX_MODE=full adds delete_entities, delete_observations and delete_relations, plus consolidate and deduplicate. The default micro set has none. github.com

• The HTTP service stays on your machine by default

  memorix background start serves on localhost port 3211. A non-local address needs MEMORIX_HTTP_AUTH_TOKEN or an explicit opt-out flag. github.com

Security advisories