Mindswap MCP Server

Keep project context and personal AI memory local so tools can continue work without re-explaining the same context.

People who work with codex, continuity and developer tools and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-05-03 · ★ 7 · #223 OF 304 MAINTAINED MEMORY · VERIFIED 2026-09-18

MIT · JavaScript servers · how we verify → /methodology

01 · Install Mindswap

Claude Code

claude mcp add shiporbleed-mindswap -- npx -y mindswap

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package mindswap - unscoped; check the name against the project README before installing

registry namespace io.github.ShipOrBleed is GitHub-verified and matches the repo owner

03 · What Mindswap can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v3.3.0 · 2026-05-03

Mindswap 3.3.0 release for npm, MCP distribution metadata, and WinGet portable asset.

04 · Who maintains Mindswap

Mindswap is maintained by shiporbleed. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

category
memory - ranked #223 of 304 actively-maintained memory servers as of 2026-09-18.
registry
io.github.ShipOrBleed/mindswap (active, first published 2026-05-01 · 2 versions)
packages
npm:mindswap

06 · Mindswap FAQ

What is Mindswap?

Keep project context and personal AI memory local so tools can continue work without re-explaining the same context.

Is Mindswap still maintained?

Yes - as of 2026-09-18, its last commit was 2026-05-03. We re-verify nightly.

How do I install Mindswap?

Run `npx -y mindswap`. You can also paste the ready-made client config above.

Does Mindswap run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Mindswap

Pairs well with

Servers that cover what Mindswap doesn't - only shown when the pairing reason fits the companion.

  1. Server Filesystem → filesystem companion filesystem · ★ 39,038
  2. Pdf MCP → filesystem companion filesystem · ★ 135