basic-memory
AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN
- 4.3k stars
- 334 forks
- 88 open issues
- Language: Python
- License: AGPL-3.0
- updated
Install
local · uvx (python)claude mcp add basic-memory -- uvx basic-memory{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": ["basic-memory"]
}
}
}{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": ["basic-memory"]
}
}
}- Run the command above in your terminal (Claude Code), or paste the JSON config into claude_desktop_config.json (Claude Desktop).
- Replace any <placeholder> values with your API keys or paths.
- Restart Claude. The MCP server and its tools appear automatically.
Package name inferred from the repository name. Verify it exists on PyPI, or clone https://github.com/basicmachines-co/basic-memory and follow its README.
Editor's note
Basic Memory is an MCP server that gives AI assistants persistent, structured memory by storing knowledge as plain Markdown files on disk or in a hosted cloud workspace. It builds a local-first knowledge graph from notes, observations, and wikilinks, and exposes that graph to Claude Desktop, Claude Code, and any other MCP-compatible client through tools tagged with behavior hints (read-only, destructive, idempotent) so agents can select the appropriate tool without wasting context window on trial and error. Semantic search lets the AI retrieve notes by meaning rather than exact keywords, and bidirectional sync keeps human edits in Obsidian or any text editor consistent with what the AI reads and writes. The self-hosted version is free under AGPL-3.0 and requires only Python via uv, while a hosted tier adds cross-device sync, point-in-time snapshots, and one-click client connection for $15 per month. Developers, consultants, and teams who want to stop re-explaining project context at the start of every conversation are the primary audience.
MCP Servers overview
What people ask about basic-memory
What is basicmachines-co/basic-memory?
basicmachines-co/basic-memory is mcp servers for the Claude AI ecosystem. AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN It has 4.3k GitHub stars and its last recorded update is dated 2026-10-23.
How do I install basic-memory?
You can install basic-memory by cloning the repository (https://github.com/basicmachines-co/basic-memory) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is basicmachines-co/basic-memory safe to use?
Our security agent has analyzed basicmachines-co/basic-memory and assigned a Trust Score of 100/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains basicmachines-co/basic-memory?
basicmachines-co/basic-memory is maintained by basicmachines-co. The last recorded GitHub activity is dated 2026-10-23, with 88 open issues.
Are there alternatives to basic-memory?
Yes. On ClaudeWave you can browse similar mcp servers at /categories/mcp, sorted by popularity or recent activity.