Basic Memory

Name: Basic Memory
Author: basicmachines-co

by basicmachines-cocommunityv0.20.2

2.8k

184

Basic Memory allows users to build a persistent knowledge base through natural conversations with Large Language Models (LLMs), utilizing Markdown files stored locally. It employs the Model Context Protocol (MCP) for integration with compatible LLMs.

From the registry: Local-first knowledge management with bi-directional LLM sync via Markdown files.

GitHub Repository

Install & configure

Prerequisites

optional
Install uv
uvx is recommended to run basic-memory directly.
https://github.com/astral-sh/uv
required
Python 3.12+
Required runtime.
https://www.python.org/

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `basic-memory` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Python 3.12+** — Required runtime. (https://www.python.org/)

Optional prerequisites:
- Install uv — uvx is recommended to run basic-memory directly. (https://github.com/astral-sh/uv)

Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["basic-memory","mcp"]

Note: Notes stored as Markdown files under ~/basic-memory by default. Optional cloud sync via 'basic-memory project set-cloud'.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Notes stored as Markdown files under ~/basic-memory by default. Optional cloud sync via 'basic-memory project set-cloud'.