limps — Claude Code MCP server: what it does, how to install
limps gives AI agents a shared local layer for Markdown files, plans, and task states. Use it when several MCP clients need the same project context.
claude mcp add limps -- npx -y @sudosandwich/limpsWhat limps does
limps connects an agent to any folder containing Markdown files. It exposes document creation, reading, updates, deletion, full-text search, plan tracking, and task status changes. The index uses SQLite while the source files stay in the folder you choose.
The server can be used from Claude Code, Codex, Cursor, and other MCP clients. Separate .limps/config.json files can target different projects, while several clients can work with the same documents. Initialize a folder with limps init; the commands limps server start, limps server stop, and limps server status control the background HTTP daemon.
A folder or configuration change requires a server restart unless the file watcher has refreshed the index. Document processing through process_doc and process_docs runs JavaScript inside a QuickJS sandbox with no network or Node APIs.
What it helps with
- keep plans in a shared folder
- search Markdown files by full text
- track task states across agents
- share project context between MCP clients
Example prompts for the agent
- Create a migration plan and add tasks for the database changes.
- Search the Markdown documents for decisions about authentication.
- Show the current plan status and suggest the next task.
How to install limps
Platform CLI
claude mcp add limps -- npx -y @sudosandwich/limpsPlatform CLI
codex mcp add limps -- npx -y @sudosandwich/limpsConfig file
{
"mcpServers": {
"limps": {
"command": "npx",
"args": [
"-y",
"@sudosandwich/limps"
]
}
}
}Config file
{
"servers": {
"limps": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sudosandwich/limps"
]
}
}
}Platform CLI
gemini mcp add limps npx -y @sudosandwich/limpsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about limps
How do I install limps in Claude Code?
Run claude mcp add limps -- npx -y @sudosandwich/limps.
What does limps do?
It gives AI agents structured access to local Markdown documents, plans, and task states. The available workflows include document operations, full-text search, and plan tracking.
Where does limps keep project data?
The files remain in the selected folder, with an SQLite index for search and access. It is designed for local use without a hosted service or subscription.
