---
name: "Give MCP clients local Markdown project memory with Basic Memory"
slug: "give-mcp-clients-local-markdown-project-memory-with-basic-memory"
description: "Connect Claude, Codex, Cursor, ChatGPT, or any MCP-capable client to a local-first Markdown knowledge graph so agents can write, search, and reuse project context across sessions."
github_stars: 3192
verification: "security_reviewed"
source: "https://github.com/basicmachines-co/basic-memory"
author: "Basic Machines"
publisher_type: "organization"
category: "Developer Tools"
framework: "MCP"
tool_ecosystem:
  github_repo: "basicmachines-co/basic-memory"
  github_stars: 3192
---

# Give MCP clients local Markdown project memory with Basic Memory

Connect Claude, Codex, Cursor, ChatGPT, or any MCP-capable client to a local-first Markdown knowledge graph so agents can write, search, and reuse project context across sessions.

## Prerequisites

Python 3.12+, uv, Basic Memory CLI, an MCP-capable client such as Claude, Codex, Cursor, ChatGPT, or VS Code, and a local Markdown workspace

## Installation

Requirements and caveats from upstream:
- [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
- Claude, Codex, or Cursor connected in 30 seconds. No Python, no JSON, no

- Source: https://github.com/basicmachines-co/basic-memory
- Extracted from upstream docs: https://raw.githubusercontent.com/basicmachines-co/basic-memory/HEAD/README.md

## Documentation

- https://github.com/basicmachines-co/basic-memory#readme

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/give-mcp-clients-local-markdown-project-memory-with-basic-memory/)