basic-memory

AI conversations that actually remember. Never re-explain your project to Claude again. Local-first, integrates with Obsidian. Join our Discord: https://discord.gg/tyvKNccgqN

GitHub Website Docs

GitHub Stars

1,742

User Rating

Not Rated

Favorites

Views

Forks

101

Issues

Installation

Difficulty

Advanced

Estimated Time

20-45 minutes

Installation

Prerequisites

Please specify required software and versions:

Python: 3.12 or higher

Installation Steps

1. Install the Tool

bash
Install with uv (recommended)
uv tool install basic-memory

or install with Homebrew
brew tap basicmachines-co/basic-memory
brew install basic-memory

2. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json to add the MCP server:

json
{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory",
        "mcp"
      ]
    }
  }
}

3. Verify Server Startup

Open Claude Desktop and confirm that the configuration has been loaded correctly.

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Python version and reinstall dependencies. Issue: Not recognized by Claude Desktop Solution: Verify configuration file path and syntax.

Additional Resources

GitHub Repository Official Documentation Official Website