basic-memory

Basic Memory is designed to facilitate the creation and management of a personal knowledge base by leveraging conversations with LLMs like Claude. It uses the Model Context Protocol (MCP) to enable LLMs to interact with local Markdown files, allowing users to store, retrieve, and structure information seamlessly. This approach ensures that knowledge is kept locally, providing users with control over their data while enabling rich, context-aware interactions with AI. Basic Memory supports real-time synchronization and can be integrated with tools like Obsidian for enhanced usability.

Features

• Local-first storage: Keeps all knowledge in local Markdown files, ensuring user control over data.
• Bi-directional interaction: Allows both users and LLMs to read and write to the same files.
• Structured simplicity: Utilizes Markdown with semantic patterns for easy knowledge management.
• Traversable knowledge graph: Enables LLMs to follow links between topics for richer context.
• Lightweight infrastructure: Operates with local files indexed in a local SQLite database.

MCP Tools

• {'write_note': 'Create or update notes with specified title, content, folder, and tags.'}
• {'read_note': 'Read notes by title or permalink.'}
• {'build_context': 'Navigate the knowledge graph via memory:// URLs.'}
• {'search_notes': 'Search across the knowledge base using queries.'}
• {'recent_activity': 'Find recently updated information.'}

Usage with Different Platforms

Claude Desktop

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

VS Code

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