Mindswap MCP server
io.github.ShipOrBleed/mindswap·v3.3.0·7 starsLocal-first AI context and memory server for cross-tool coding continuity.
7 stars
Reviews
Write oneNobody has reviewed Mindswap yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Mindswap tools (4)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
mindswap_get_contextGet complete project context for this coding session. Call this FIRST when starting work on a project. Returns: project info, current task, recent decisions, what's in-progress, conventions, conflicts, and test status — all synthesized into a single briefing.
mindswap_memoryManage structured memory items. Use this to list, add, update, resolve, archive, or delete blockers, assumptions, questions, and resolutions.
mindswap_save_contextSave session context before ending work or when significant progress is made. Records what was accomplished, decisions made, and what should happen next. This ensures the next AI session (in any tool) can pick up seamlessly.
mindswap_searchSearch project context for specific information. Use when you need to know about a past decision, convention, or what happened with a specific feature. Searches decisions log, session history, and project state.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan40 source files scanned13/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 147 days ago8/15
- Maintainer identityregistry namespace matches repository owner7/10
Findings (1)
- highShell command built from a string (injection risk)
exec.shell-concatsrc/pr.js: …ileSync(tmpFile, newBody, 'utf-8'); execSync(`gh pr edit ${pr.number} --body-file "${tmpFile}"`, { cwd: projectRoot, st…
How Mindswap compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 62/100
- higher than 17% of 48,255 servers
- Tools
- 4
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 7
- more than 86% of 28,688 servers
What its tools let an agent do: 4 read
Install Mindswap in Claude Code, Cursor or VS Code
Runs npx -y mindswap on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mindswap -- npx -y mindswap
What the publisher says
From the Mindswap repository's README, as published. We do not edit it. Read it on GitHub
mindswap
Keep project context and personal AI memory local so tools can continue work without re-explaining the same context.
Why it exists
AI sessions reset too often. mindswap saves the current task, decisions, blockers, and handoff context so the next tool can pick up cleanly.
Install
npm install mindswap --save-devQuick start
npx mindswap init
npx mindswap
npx mindswap doctor
npx mindswap resume
npx mindswap ask "Why did we choose JWT?"What it gives you
- init to set up a repo and import existing AI context
- save to capture the current task, git state, and decisions
- doctor to check setup health and stale context
- resume to start with a clean briefing
- ask to search project memory with citations
- memory to manage blockers, assumptions, questions, and resolutions
- --global memory and ask scope for personal cross-tool memory under ~/.mindswap/
- reindex to rebuild the local SQLite search index from your file-based memory
- sync to share continuity state across machines
- mcp and mcp-http to expose the same context to AI clients
Global personal memory
MindSwap now supports two local memory scopes:
- repo memory in /.mindswap/
- personal memory in ~/.mindswap/
Use global memory when a preference or learning should follow you across projects and tools.
npx mindswap log "Prefer concise explanations" --type assumption --global
npx mindswap memory list --scope all
npx mindswap ask "What explanation style should we use?" --scope all
npx mindswap reindex --scope allMCP and AI tools
mindswap generates context for tools like Claude Code, Cursor, Copilot, Codex, Windsurf, Cline, Roo, Aider, Amp, Gemini CLI, and AGENTS.md-based workflows.
npx mindswap mcp-install
npx mindswap mcp-httpProject state
The main repo data lives in .mindswap/:
.mindswap/
├── HANDOFF.md
├── state.json
├── decisions.log
├── memory.json
├── config.json
├── branches/
└── history/npm package
- npm: https://www.npmjs.com/package/mindswap
- GitHub: https://github.com/ShipOrBleed/mindswap
Use it
If mindswap helps your workflow, star the repo and keep improving the handoff loop.
Nothing above is checked by us. What we check is on the safety report.
Mindswap: common questions
- Is Mindswap MCP server safe?
- With care: it is graded C, so read the findings first (62/100). Read the Mindswap safety report
- How do I install Mindswap?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Mindswap need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Mindswap maintained?
- The last commit was 185 days ago (2026-05-03). The latest release is v3.3.0.
- What can I use instead of Mindswap?
- Servers from other publishers that do the same job: Deja Vu MCP server, Concord MCP server and Memorix MCP server.
- How does Mindswap compare with other MCP servers?
- safety score 62/100 (higher than 17% of 48,255 servers); tools 4 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Mindswap
Same job from other publishers: the closest match first, then the best rated.
- Deja Vudeja-vu: local memory over the session histories of forty-three coding agents.not reviewedEstablishedA
- Concord MCPCross-harness communication and shared work-state for AI coding agents.not reviewedEstablishedA
MemorixLocal-first project memory with legacy MCP and 2026 discovery compatibility.not reviewedEstablishedB- Nautilus Compass MemoryLocal-first long-term memory for AI agents, with byte-recomputable signed verification receipts.not reviewedEstablishedB