drio
Open app

Basic Memory

Source

Knowledge management system that allows you to build a persistent semantic graph from conversations with AI assistants. All knowledge is stored in standard Markdown files on your computer, giving you full control and ownership of your data. Integrates directly with Obsidan.md

Catalog onlyCatalog onlySTDIO

Overview

Basic Memory is a knowledge management system that allows users to build a persistent semantic graph from conversations with AI assistants, storing all knowledge in standard Markdown files on their computer.

To use Basic Memory, install it via the command line, configure it with your AI assistant (like Claude), and start creating notes by conversing with the AI. You can also manage projects and sync your knowledge base using CLI commands.

  • Local storage of knowledge in Markdown format - Integration with AI assistants for dynamic note-taking - Bidirectional synchronization between AI and user notes - Support for multiple projects and semantic relationships - Easy access and editing through familiar tools like Obsidian
  1. Building a personal knowledge base that evolves over time.
  2. Capturing and structuring information from conversations with AI.
  3. Managing separate knowledge graphs for different projects or topics.

Add to your AI client

Use these steps to connect Basic Memory in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "basic-memory-basicmachines-co": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-basic-memory-basicmachines-co"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "basic-memory-basicmachines-co": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-basic-memory-basicmachines-co"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "basic-memory-basicmachines-co": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-basic-memory-basicmachines-co"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "basic-memory-basicmachines-co": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-basic-memory-basicmachines-co"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "basic-memory-basicmachines-co": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-basic-memory-basicmachines-co"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "basic-memory-basicmachines-co": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-basic-memory-basicmachines-co"
      ]
    }
  }
}

FAQ

Can I use Basic Memory with any AI assistant?

Yes, Basic Memory is designed to work with any compatible AI assistant using the Model Context Protocol (MCP).

Is my data secure with Basic Memory?

Yes, all data is stored locally on your computer, giving you full control and ownership.

How do I back up my knowledge?

You can back up your Markdown files using standard file backup methods.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2344,"uuid":"747252c0-c00c-46e1-ad6e-1174fdb8e0b0","name":"basic-memory","title":"Basic Memory","description":"Knowledge management system that allows you to build a persistent semantic graph from conversations with AI assistants. All knowledge is stored in standard Markdown files on your computer, giving you full control and ownership of your data. Integrates directly with Obsidan.md","avatar_url":null,"created_at":"2025-03-11T18:57:07.634Z","updated_at":"2025-03-12T11:37:41.220Z","status":"created","author_name":"basicmachines-co","author_avatar_url":null,"tags":"knowledge-management,semantic-graph,markdown-files","category":"knowledge-and-memory","is_featured":false,"sort":1,"url":"https://github.com/basicmachines-co/basic-memory","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":"0d5a619f-b22f-471c-994f-39af29c79969","tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Knowledge and memory