{
  "name": "io.github.basicmachines-co/basic-memory",
  "description": "Basic Memory gives an AI agent persistent, cross-session recall by writing notes to plain Markdown files on disk and building a semantic graph over them. Unlike a managed cloud memory or an opaque vector index, every memory is a human-readable Markdown file in a folder you control — editable in any text editor, viewable in Obsidian, and versionable in git. The agent writes a note, links it to related notes, and on the next session reads the relevant slice back. It is the memory layer for people who want their agent's memory to be inspectable, portable, and theirs.",
  "status": "active",
  "version": "0.22.1",
  "_meta": {
    "com.top-mcps/lastVerified": "2026-06-22",
    "com.top-mcps/score": {
      "value": 81,
      "rubricVersion": "2026-04",
      "lastComputed": "2026-06-22T09:44:48.966Z",
      "methodology": "https://top-mcps.com/about/methodology"
    },
    "com.top-mcps/stats": {
      "fetchedAt": "2026-06-22T09:44:47.864Z",
      "githubStars": 3273,
      "lastCommitAt": "2026-06-14T22:25:17Z"
    }
  },
  "repository": {
    "url": "https://github.com/basicmachines-co/basic-memory",
    "source": "github"
  },
  "author": {
    "name": "Basic Machines"
  },
  "packages": [
    {
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "identifier": "basic-memory",
      "version": "0.22.1",
      "transport": {
        "type": "stdio"
      },
      "runtimeArguments": [
        {
          "type": "positional",
          "value": "mcp"
        }
      ],
      "environmentVariables": [
        {
          "name": "BASIC_MEMORY_PROJECT",
          "description": "BASIC_MEMORY_PROJECT — required credential for Basic Memory.",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ],
  "capabilities": {
    "tools": [
      {
        "name": "write_note",
        "description": "Create or update a Markdown note in the knowledge base.",
        "sideEffect": "write",
        "args": [
          {
            "name": "title",
            "type": "string",
            "required": true
          },
          {
            "name": "content",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "read_note",
        "description": "Read a note by title or path.",
        "sideEffect": "read",
        "args": [
          {
            "name": "identifier",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "search",
        "description": "Full-text and semantic search across notes.",
        "sideEffect": "read",
        "args": [
          {
            "name": "query",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "build_context",
        "description": "Traverse the note graph to assemble relevant context for a topic.",
        "sideEffect": "read",
        "args": [
          {
            "name": "url",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "recent_activity",
        "description": "List recently created or edited notes.",
        "sideEffect": "read"
      }
    ],
    "security": {
      "scope": "read-write",
      "sandbox": "Reads and writes Markdown files inside the configured project directory. No outbound network calls unless cloud sync is explicitly enabled.",
      "gotchas": [
        "Tools can delete and overwrite notes — point it at a dedicated folder, not your whole home directory.",
        "AGPL-3.0 is copyleft; review it before bundling Basic Memory into a distributed product.",
        "A misconfigured project path can let the agent write outside the intended vault — set BASIC_MEMORY_PROJECT explicitly."
      ]
    }
  },
  "_links": {
    "html": "https://top-mcps.com/mcp/basic-memory",
    "markdown": "https://top-mcps.com/mcp/basic-memory.md",
    "methodology": "https://top-mcps.com/about/methodology"
  }
}