# MemoryPilot MCP server

Long-term memory for AI agents: fast recall, project brains and skills, local, in one binary.

## At a glance

MemoryPilot is an MCP server in the AI & Memory category. It runs locally over stdio via `npx -y https://github.com/Soflutionltd/MemoryPilot/releases/download/v4.13.0/memorypilot.mcpb`, and declares no required credentials. It exposes 14 tools, including recall, get_project_brain and search_memory. It scores B (76/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install MemoryPilot in Claude Code

1. Add the server

```bash
claude mcp add memorypilot -- npx -y https://github.com/Soflutionltd/MemoryPilot/releases/download/v4.13.0/memorypilot.mcpb
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. recall, get_project_brain, search_memory). It discovers them automatically.

### How to install MemoryPilot in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "memorypilot": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/MemoryPilot/releases/download/v4.13.0/memorypilot.mcpb"
      ]
    }
  }
}
```

3. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install MemoryPilot in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "memorypilot": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/MemoryPilot/releases/download/v4.13.0/memorypilot.mcpb"
      ]
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install MemoryPilot in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.memorypilot]
command = "npx"
args = ["-y", "https://github.com/Soflutionltd/MemoryPilot/releases/download/v4.13.0/memorypilot.mcpb"]
```

2. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install MemoryPilot in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "memorypilot": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/MemoryPilot/releases/download/v4.13.0/memorypilot.mcpb"
      ]
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install MemoryPilot in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "memorypilot": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/MemoryPilot/releases/download/v4.13.0/memorypilot.mcpb"
      ]
    }
  }
}
```

### How to install MemoryPilot in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "memorypilot": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Soflutionltd/MemoryPilot/releases/download/v4.13.0/memorypilot.mcpb"
      ]
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `recall` — Start here. Loads all context in one shot: project memories, scoped thread/window memories, preferences, critical facts, patterns, decisions, global prompt. Supports `mode = safe/default/full`, `compact = true` for AAAK compression.
- `get_project_brain` — Instant project summary (<1500 tokens): tech stack, architecture, bugs, recent changes, components, team members. Supports `compact = true`.
- `search_memory` — Hybrid BM25 + jina RRF search, boosted by importance, graph links, and file watcher context. Batched triple scoring.
- `get_file_context` — Memories related to recently modified files in working directory.
- `find_conversation` — Finds a past conversation from a vague description, across Cursor (every window, sub-agents folded into their conversation), Claude Code and Claude desktop agent sessions. Exact words and stems, misheard words (one or two letters off, split
- `read_conversation` — Reads a found conversation, paginated, optionally centred on the matching message.
- `add_memory` — Store with lazy embedding, auto-dedup (hash exact + Jaccard 85%), auto entity extraction, auto graph linking, auto-classification (kind, importance, TTL inferred from content).
- `add_memories` — Bulk add multiple memories in one call with per-item dedup.
- `add_transcript` — Store a long transcript as chunked archive, auto-distill structured memories (`decision`, `preference`, `todo`, `bug`, `milestone`, `problem`, `note`).
- `ingest_session` — Ingest local Claude/Cursor/session transcripts into the same MemoryPilot MCP. Defaults to `distill_only=true`, so only high-value memories are indexed.
- `get_memory` — Retrieve by ID.
- `update_memory` — Update content, kind, tags, importance, TTL. Skips re-embedding if content unchanged (hash check).
- `delete_memory` — Delete by ID (cascades to entities and links).
- `list_memories` — List with project/kind filters and pagination.

Source repository: https://github.com/Soflutionltd/MemoryPilot

---

Source: https://mcp-skills-hub.vercel.app/mcps/com-soflution-memorypilot · MCP Skills Hub · data as of 2026-10-28T12:31:05Z