Skip to content
MCP server

SuperLocalMemory

Local-first memory for agents that cites sources and says when it doesn't know

Runs locallyStatus and history
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
4.2.19
Listing updated
3 days ago

About SuperLocalMemory

SuperLocalMemory is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Every recall ends in one of three outcomes: a supported answer, the closest memories with a note that there is no exact match, or a plain statement that the thing is not stored. The point is to avoid a confident guess. A saved fact can replace an older one, the old memory is kept, and the change can be undone; each fact records when it happened and when it was learned.

In its local mode the core remember and recall calls make no model-provider call, so no API key or cloud account is needed. An on-device judge, enabled by default on Apple Silicon, checks whether the found memories answer the question, and an online check runs only after you consent. Screenshots, photos and PDFs can be indexed with local OCR and answers cite file and page.

For teams it adds roles, workspaces, a hash-chained audit trail, erasure and GDPR export, plus a mesh for messaging between local agents and web bots. Recall is layered under a hard token cap. It installs from npm or pip, supports Claude Code, Codex, Cursor and others, and the core is AGPL v3.

Install

Run in a terminal

claude mcp add superlocalmemory -- npx -y superlocalmemory

Add to claude_desktop_config.json

{
  "mcpServers": {
    "superlocalmemory": {
      "command": "npx",
      "args": [
        "-y",
        "superlocalmemory"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "superlocalmemory": {
      "command": "npx",
      "args": [
        "-y",
        "superlocalmemory"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "superlocalmemory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "superlocalmemory"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "superlocalmemory": {
      "command": "npx",
      "args": [
        "-y",
        "superlocalmemory"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "superlocalmemory": {
      "command": "npx",
      "args": [
        "-y",
        "superlocalmemory"
      ]
    }
  }
}

What it does

Three-tier recall
Supported answer, closest memories, or an explicit not-found.
Replaceable facts
New facts can replace old ones with undo.
Local documents and images
OCR and image search cite file and page.
Governance
Roles, workspaces, audit trail and GDPR export.
Agent trust scores
Records which agent wrote each memory.
SLM-Mesh
Messages, locks and shared state between agents and bots.
Capped recall
Layered output under a hard token limit.

Good for

  • Share one memory across several coding agents
  • Ask what was true last month
  • Search screenshots and PDFs by description
  • Keep an audit trail of agent memory writes
  • Stop agents guessing when nothing is stored

Pricing

Open source

Prices change. Check superlocalmemory.com before you buy.

SuperLocalMemory FAQ

Does it need an API key?

In Mode A, core remember and recall make no model-provider call, so no key, cloud account or Docker.

How do I install it?

npm install -g superlocalmemory, then slm setup; pip is the other route.

What license?

AGPL v3 for the free local core.

Which platforms?

Windows, Linux and macOS.

Is SuperLocalMemory free?

Yes. SuperLocalMemory is open source, so you can use and self-host it for free.

How do I add SuperLocalMemory to Claude Code?

Run this command in your terminal: claude mcp add superlocalmemory -- npx -y superlocalmemory

What are the best alternatives to SuperLocalMemory?

The closest alternatives to SuperLocalMemory are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to SuperLocalMemory

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity