Basic Memory

Name: Basic Memory
Author: Basic Machines

Basic MachinesOfficial

Local-first AI memory: a semantic knowledge graph of Markdown files that agents read and write across sessions, with optional cloud sync.

Setup

Choose your client, copy the config, then fill in any required environment variables.

claude mcp add basic-memory -- uvx basic-memory

~/.codex/config.toml

[mcp_servers.basic-memory]
command = "uvx"
args = ["basic-memory"]

# codex mcp add basic-memory -- uvx basic-memory

~/.cursor/mcp.json

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

.vscode/mcp.json

{
  "servers": {
    "basic-memory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "basic-memory"
      ]
    }
  }
}

~/.gemini/settings.json

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

claude_desktop_config.json

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

.trae/mcp.json

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