Basic Memory

listing.about

Basic Memory stores what you and your AI talk about as plain Markdown files on your disk. Notes use observations and wikilinks to form a knowledge graph. Both you and the assistant can write to the same files, and sync keeps them aligned. It also offers semantic search and works with Obsidian, since it reads and writes the same Markdown.

It runs locally over stdio as a Python package started with uvx, and needs no sign-in or API key. The --prerelease=allow flag is required because of a pre-release FastMCP dependency. A hosted Basic Memory Cloud option exists at https://cloud.basicmemory.com/mcp with OAuth sign-in and a paid plan.

listing.can

• Store AI conversation context as local Markdown notes
• Build a knowledge graph from observations and wikilinks
• Search notes by keyword or by meaning with semantic search
• Edit the same files by hand or through the assistant
• Work with Obsidian and other MCP clients
• Optionally use the hosted cloud version for cross-device sync

listing.tools

listing.notools.local

listing.prompts

• Save a note summarizing our decisions about the API design.

• What did we decide last week about the database schema?

• Search my notes for anything related to authentication.

• Continue from where we left off on the migration project.

listing.setup.h

listing.setup.local

claude mcp add --transport stdio basic-memory -- uvx --prerelease=allow basic-memory mcp

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

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

code --add-mcp '{"name":"basic-memory","type":"stdio","command":"uvx","args":["--prerelease=allow","basic-memory","mcp"]}'

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

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

codex mcp add basic-memory -- uvx --prerelease=allow basic-memory mcp

[mcp_servers.basic-memory]
command = "uvx"
args = ["--prerelease=allow", "basic-memory", "mcp"]

gemini mcp add basic-memory uvx -- --prerelease=allow basic-memory mcp

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

listing.faq

listing.em.h

listing.em.lead_local listing.em.how

listing.em.badge listing.em.widget iframe JSON

listing.em.badge

Markdown

[![Basic Memory on mcp.tc](https://mcp.tc/i/basic-memory/badge.svg)](https://mcp.tc/i/basic-memory)

HTML

<a href="https://mcp.tc/i/basic-memory"><img src="https://mcp.tc/i/basic-memory/badge.svg" alt="Basic Memory on mcp.tc" height="20"></a>

listing.em.badge_note

listing.em.widget

HTML

<script src="https://mcp.tc/w/basic-memory.js" async></script>

listing.em.widget_note

iframe

HTML

<iframe src="https://mcp.tc/embed/basic-memory" title="Basic Memory on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

listing.em.iframe_note

JSON

listing.em.json_local

https://mcp.tc/i/basic-memory.json

listing.em.fields