Mindswap
@ShipOrBleed
About Mindswap
Local-first AI context and memory server for cross-tool coding continuity. MindSwap helps coding agents and developers persist project context, search prior decisions, manage structured memory, resume work across sessions, and keep MCP-compatible tools aligned through one shared
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mindswap": {
"command": "npx",
"args": [
"-y",
"mindswap",
"mcp"
]
}
}
}Tools
No tools detected
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
What is Mindswap?
Mindswap is a local-first MCP server and CLI for persistent coding context across sessions. It helps developers and AI coding tools save project and task context, search previous work and decisions, manage structured memory, resume interrupted work, and share one continuity layer across MCP-compatible tools.
How to use Mindswap?
Install by adding a JSON configuration with npx -y mindswap mcp as the command and args in your MCP client’s mcpServers block. Use the MCP tools (mindswap_get_context, mindswap_save_context, mindswap_search, mindswap_memory) through the client, or run CLI commands directly (mindswap init, mindswap save, mindswap checkpoint, mindswap summary, mindswap resume, mindswap search, mindswap ask, mindswap memory, mindswap doctor, mindswap reindex).
Key features of Mindswap
- Persistent coding context across sessions
- Save and search project context and decisions
- Manage structured memory (decisions, blockers, follow-ups)
- Resume interrupted work seamlessly
- Works locally with MCP-compatible tools
Use cases of Mindswap
- Restore a coding session’s context after a break using
mindswap resume - Search past decisions and blockers during a project
- Keep a continuity layer shared across different AI coding tools
- Track follow-ups and unanswered questions with
mindswap memory
FAQ from Mindswap
How do I install Mindswap?
Add a JSON entry to your MCP client’s configuration: "mindswap": { "command": "npx", "args": ["-y", "mindswap", "mcp"] }.
What MCP tools does Mindswap include?
It provides mindswap_get_context, mindswap_save_context, mindswap_search, and mindswap_memory.
Is Mindswap cloud-based or local-first?
Mindswap is described as “local-first”, meaning data stays on your machine and sessions persists there.
How do I use the CLI part of Mindswap?
After installation, run commands like mindswap init, mindswap save, mindswap checkpoint, mindswap summary, mindswap resume, mindswap search, mindswap ask, mindswap memory, mindswap doctor, or mindswap reindex.
Where can I find more about Mindswap?
The GitHub repository is at https://github.com/ShipOrBleed/mindswap, and the package is on npm at https://www.npmjs.com/package/mindswap.
Frequently asked questions
How do I install Mindswap?
Add a JSON entry to your MCP client’s configuration: `"mindswap": { "command": "npx", "args": ["-y", "mindswap", "mcp"] }`.
What MCP tools does Mindswap include?
It provides `mindswap_get_context`, `mindswap_save_context`, `mindswap_search`, and `mindswap_memory`.
Is Mindswap cloud-based or local-first?
Mindswap is described as “local-first”, meaning data stays on your machine and sessions persists there.
How do I use the CLI part of Mindswap?
After installation, run commands like `mindswap init`, `mindswap save`, `mindswap checkpoint`, `mindswap summary`, `mindswap resume`, `mindswap search`, `mindswap ask`, `mindswap memory`, `mindswap doctor`, or `mindswap reindex`.
Where can I find more about Mindswap?
The GitHub repository is at https://github.com/ShipOrBleed/mindswap, and the package is on npm at https://www.npmjs.com/package/mindswap.
Basic information
More Other MCP servers
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Production-ready MCP integrations for AI applications
Klavis-AIKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Glasswarp
GlasswarpSee and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Comments