basic-memory
Local-first knowledge management with bi-directional LLM sync via Markdown files.
File SystemsAI & MLpython
How to use
basic-memory is an MCP server that lets your AI assistant read, search, and edit files in a directory you allow.
- Best for giving an assistant safe access to a local project or document folder.
- Works in any MCP-compatible client — Claude Desktop, Claude Code, Cursor, and others.
- Add it once to your client config; its tools then appear to the assistant automatically.
Install
Distributed as a PyPI package. Prerequisite: Python 3.10+ and uv — https://docs.astral.sh/uv/.
- 1Install the prerequisite above if you don't have it.
- 2Open your Claude Desktop config (create it if missing):
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- 3Add this under
mcpServers(merge if the key already exists):{ "mcpServers": { "basic-memory": { "command": "uvx", "args": ["basic-memory"] } } } - 4Save the file and fully quit, then reopen Claude Desktop.
- 5Click the tools (🔌) icon — basic-memory's tools should now be listed.
Capabilities
No capabilities documented for this server yet.
Reviews (0)
No reviews yet. Be the first to review this server.