# Basic Memory Documentation

> Documentation for Basic Memory - a knowledge management system that gives AI assistants persistent memory through the Model Context Protocol (MCP). Supports both cloud and local deployments.

## Documentation Sets

- [Basic Memory Complete Documentation](https://docs.basicmemory.com/llms-full.txt): Complete technical documentation for Basic Memory including setup guides, MCP tools reference, knowledge format specifications, and integration guides for Claude, ChatGPT, Gemini, and other AI assistants.

## Landing

- [Basic Memory](https://docs.basicmemory.com/raw/index.md): AI and humans working together to build knowledge that gets smarter over time

## Docs

- [What is Basic Memory](https://docs.basicmemory.com/raw/start-here/what-is-basic-memory.md): An overview of what Basic Memory is and how it works.
- [Quickstart: Cloud](https://docs.basicmemory.com/raw/start-here/quickstart-cloud.md): Connect Basic Memory Cloud and create your first note in 2 minutes.
- [Quickstart: Local](https://docs.basicmemory.com/raw/start-here/quickstart-local.md): Install Basic Memory locally and connect it to your AI assistant.
- [Getting Started](https://docs.basicmemory.com/raw/start-here/getting-started.md): Configure where notes are saved and manage multiple projects.
- [Why Basic Memory](https://docs.basicmemory.com/raw/start-here/why-basic-memory.md): Your AI already has memory features. Here's why you still want a knowledge base you own — and how Basic Memory is different from the alternatives.
- [Basic Memory Teams](https://docs.basicmemory.com/raw/whats-new/teams.md): Share a cloud workspace with your team — invite members, assign roles, and build one knowledge base together.
- [v0.21.0](https://docs.basicmemory.com/raw/whats-new/v0.21.0.md): Basic Memory Teams support — shared cloud workspaces that work consistently across MCP and CLI, plus faster search and sync and smarter Markdown parsing in v0.21.
- [Hermes Plugin](https://docs.basicmemory.com/raw/whats-new/hermes-plugin.md): Give Hermes Agent persistent Basic Memory — search-before-answer recall, auto-capture, and 10 agent tools.
- [Basic Memory Cloud](https://docs.basicmemory.com/raw/whats-new/cloud.md): Cloud UI updates and new features.
- [Basic Memory](https://docs.basicmemory.com/raw/whats-new/changelog.md): Release notes for Basic Memory.
- [Agent Skills](https://docs.basicmemory.com/raw/whats-new/agent-skills.md): Pre-built skills that teach AI agents how to use Basic Memory effectively.
- [OpenClaw Plugin](https://docs.basicmemory.com/raw/whats-new/openclaw-plugin.md): Give OpenClaw agents persistent Basic Memory with search, auto-capture, and bundled skills.
- [AI-Friendly Documentation](https://docs.basicmemory.com/raw/whats-new/ai-friendly-docs.md): Access Basic Memory docs as clean markdown for AI agents using llms.txt and content negotiation.
- [Basic Memory Cloud](https://docs.basicmemory.com/raw/cloud/cloud-guide.md): Cloud remote MCP setup, web editor, CLI tools, and snapshots for Basic Memory Cloud.
- [Web App](https://docs.basicmemory.com/raw/cloud/web-app.md): Complete guide to the Basic Memory Cloud web app - browse, edit, search, and collaborate on your notes in the browser.
- [Cloud Sync Guide](https://docs.basicmemory.com/raw/cloud/cloud-sync.md): Guide to syncing your local Basic Memory projects with Basic Memory Cloud.
- [User Guide](https://docs.basicmemory.com/raw/cloud/user-guide.md): Learn how to effectively use Basic Memory Cloud in your daily workflow to build rich semantic knowledge.
- [Cloud Snapshots](https://docs.basicmemory.com/raw/cloud/cloud-snapshots.md): Point-in-time backups for your Basic Memory Cloud knowledge base.
- [Themes](https://docs.basicmemory.com/raw/cloud/themes.md): Customize the look and feel of Basic Memory Cloud with preset themes or custom CSS.
- [API Keys](https://docs.basicmemory.com/raw/cloud/api-keys.md): Create API keys for programmatic access to Basic Memory Cloud without OAuth.
- [Local & Cloud Routing](https://docs.basicmemory.com/raw/cloud/routing.md): Choose where each project lives — on your computer, in the cloud, or a mix of both.
- [Shared Notes](https://docs.basicmemory.com/raw/cloud/shared-notes.md): Create a public, read-only link to a note so anyone can view it — no account required.
- [Edit Locally and in the App](https://docs.basicmemory.com/raw/cloud/edit-locally-and-in-the-app.md): Happy-path setup for hybrid editing — work on the same project in Obsidian or VS Code locally and in the cloud app, with bidirectional sync keeping both sides in step.
- [Restore Lost Content](https://docs.basicmemory.com/raw/cloud/restore-lost-content.md): Recover a single note from File history, or roll back a bigger change from a Snapshot — pick the right tier and follow the exact steps.
- [File History](https://docs.basicmemory.com/raw/cloud/file-history.md): Per-note version history in the cloud — open File history on any note to see every saved version and restore or merge in old content.
- [Basic Memory Teams](https://docs.basicmemory.com/raw/teams/about.md): Share a cloud workspace with your team — invite members, assign roles, and collaborate on the same projects.
- [Joining a Team Workspace](https://docs.basicmemory.com/raw/teams/join-a-team.md): First-time setup for new team members — accept the invite, sign in, switch workspaces, and connect your AI assistant to the shared knowledge base.
- [Copy Content Between Workspaces](https://docs.basicmemory.com/raw/teams/copy-between-workspaces.md): Move notes, folders, or whole projects between personal, team, and local workspaces using export/import or MCP.
- [Local install](https://docs.basicmemory.com/raw/local/local-install.md): Install Basic Memory locally and choose where notes live.
- [CLI basics](https://docs.basicmemory.com/raw/local/cli-basics.md): Common commands for projects, notes, and search.
- [MCP tools (local)](https://docs.basicmemory.com/raw/local/mcp-tools-local.md): Use MCP tools against local projects.
- [User Guide](https://docs.basicmemory.com/raw/local/user-guide.md): Learn how to effectively use Basic Memory in your daily workflow to build rich semantic knowledge.
- [Using Basic Memory with Built-in AI Memory](https://docs.basicmemory.com/raw/concepts/vs-built-in-memory.md): How to use Basic Memory alongside the memory features in Claude, ChatGPT, and Cursor — what goes where, and how they complement each other.
- [Knowledge Format](https://docs.basicmemory.com/raw/concepts/knowledge-format.md): Basic Memory stores knowledge as plain markdown files with simple patterns that create a searchable, connected knowledge graph.
- [Projects and folders](https://docs.basicmemory.com/raw/concepts/projects-and-folders.md): Projects are separate knowledge bases in Basic Memory. Learn when to use multiple projects, how folders work inside them, and how cloud routing keeps your data where you want it.
- [Observations and relations](https://docs.basicmemory.com/raw/concepts/observations-and-relations.md): How Basic Memory turns your notes into searchable facts and a connected knowledge graph — and why you rarely need to write the syntax yourself.
- [Memory URLs](https://docs.basicmemory.com/raw/concepts/memory-urls.md): Address notes directly with memory:// paths, including project-prefixed routing.
- [Canvas Visualizations](https://docs.basicmemory.com/raw/concepts/canvas.md): Create visual knowledge maps using Obsidian's Canvas feature to understand relationships between concepts
- [Schema System](https://docs.basicmemory.com/raw/concepts/schema-system.md): Define, validate, and evolve note structure in Basic Memory with schemas.
- [Semantic Search](https://docs.basicmemory.com/raw/concepts/semantic-search.md): Meaning-based retrieval with vector and hybrid search in Basic Memory.
- [Metadata Search](https://docs.basicmemory.com/raw/concepts/metadata-search.md): Filter and find notes by their YAML frontmatter — status, type, tags, priority, confidence, custom fields, and more.
- [Claude Desktop](https://docs.basicmemory.com/raw/integrations/claude-desktop.md): Give Claude a persistent memory that grows with every conversation.
- [OpenClaw Plugin](https://docs.basicmemory.com/raw/integrations/openclaw.md): Give OpenClaw agents persistent Basic Memory with composited search, auto-capture, slash commands, and bundled workflow skills.
- [Hermes Plugin](https://docs.basicmemory.com/raw/integrations/hermes.md): Give Hermes Agent persistent Basic Memory: search-before-answer recall, per-turn capture, end-of-session summaries, 10 agent tools, slash commands, and a bundled skill.
- [Claude Research Mode](https://docs.basicmemory.com/raw/integrations/claude-research-mode.md): Why your MCP connectors (including Basic Memory) aren't available during a Claude advanced-research run — and the recommended flow for combining research with your knowledge base.
- [Claude Code](https://docs.basicmemory.com/raw/integrations/claude-code.md): Give Claude Code persistent memory with Basic Memory. Decisions, architecture, and project context carry over across every coding session.
- [ChatGPT](https://docs.basicmemory.com/raw/integrations/chatgpt.md): Use ChatGPT with Basic Memory Cloud for MCP-powered knowledge access
- [Google Gemini](https://docs.basicmemory.com/raw/integrations/gemini.md): Connect Basic Memory to Google Gemini CLI for persistent knowledge across AI sessions
- [OpenAI Codex](https://docs.basicmemory.com/raw/integrations/codex.md): Give OpenAI Codex persistent memory with Basic Memory and MCP. Architecture decisions, API designs, and project context follow you across every session — in the Codex app and the Codex CLI.
- [Cursor](https://docs.basicmemory.com/raw/integrations/cursor.md): Give Cursor persistent memory with Basic Memory. Full notes, semantic search, and rich context that outlasts built-in memories.
- [VS Code](https://docs.basicmemory.com/raw/integrations/vscode.md): Edit your Basic Memory knowledge base directly in VS Code with full IDE features and terminal CLI access
- [Obsidian](https://docs.basicmemory.com/raw/integrations/obsidian.md): Visualize your knowledge graph and edit notes directly in Obsidian.
- [Agent Skills](https://docs.basicmemory.com/raw/integrations/skills.md): Pre-built skills that teach AI agents how to use Basic Memory effectively.
- [Code Project Documentation](https://docs.basicmemory.com/raw/how-to/project-documentation.md): Keep living project documentation alongside your code using Basic Memory and your AI assistant
- [Organizing Notes for Writing](https://docs.basicmemory.com/raw/how-to/writing-organization.md): Organize a writing project in Basic Memory — characters, plots, research, and drafts in a knowledge base your AI can help you navigate
- [Research & Learning](https://docs.basicmemory.com/raw/how-to/research-learning.md): Use Basic Memory and your AI to build a connected research knowledge base that grows with you
- [Note Taking](https://docs.basicmemory.com/raw/how-to/note-taking.md): How to use Basic Memory for collaborative note-taking — capture notes in markdown, let your AI enhance and connect them, then find anything later with semantic search.
- [Personal Knowledge Management](https://docs.basicmemory.com/raw/how-to/personal-knowledge.md): Use Basic Memory as a personal life operating system — track goals, reflect on experiences, and let AI find patterns across every area of your life
- [CLI Reference](https://docs.basicmemory.com/raw/reference/cli-reference.md): Command-line reference for Basic Memory local and cloud workflows.
- [MCP Tools Reference](https://docs.basicmemory.com/raw/reference/mcp-tools-reference.md): Current MCP tool reference for Basic Memory local and cloud usage.
- [AI Assistant Guide](https://docs.basicmemory.com/raw/reference/ai-assistant-guide.md): Guide for AI assistants using Basic Memory through the Model Context Protocol (MCP).
- [Technical Information](https://docs.basicmemory.com/raw/reference/technical-information.md): Technical details about Basic Memory implementation, architecture, licensing, and Model Context Protocol integration
- [Troubleshooting](https://docs.basicmemory.com/raw/reference/troubleshooting.md): Common issues and solutions for Basic Memory.
- [Configuration](https://docs.basicmemory.com/raw/reference/configuration.md): Configuration reference for Basic Memory, including project routing, semantic search, and cloud settings.
- [Docker](https://docs.basicmemory.com/raw/reference/docker.md): Run Basic Memory in Docker containers for server deployments and SSE transport
- [AI-Friendly Documentation](https://docs.basicmemory.com/raw/reference/llms-txt.md): Access documentation as clean markdown for AI agents using llms.txt and content negotiation.
- [v0.19.0 Migration Guide](https://docs.basicmemory.com/raw/reference/v0.19-migration.md): Configuration and behavior changes when upgrading from v0.18 to v0.19.