mcp-server

basic-memory — Persistent AI chats that keep your project context

Founders get AI conversations that remember details, so you never waste time re‑explaining. Ideal for Python‑based, privacy‑first workflows. 4.3k+ GitHub stars

From the repo · “AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN”

intermediate⏱ 30 minutes💵 Free
4,325 stars+89★ this week333 forksPythonGuide quality 8/10 · reviewed Oct 21Updated 10/23/2026100% free · open source
What it is

Start a conversation with an AI agent that can remember past chats.

Real use case example

"A founder of a travel company wants to create an automated chatbot to answer customer questions. They start by describing the conversation flow in Markdown (e.g., 'User asks destination information, bot responds with relevant details'). They then use the basic-memory skill to train the AI agent to retain this information and recall it for subsequent conversations. The outcome is an effective and efficient customer support system."

Best insideClaude DesktopClaude CodeGemini
When to use it
  • •You need to have ongoing conversations with your AI about a specific project or topic
  • •You want to reduce the time spent re-explaining context to your AI
  • •You're looking for a more efficient way to manage knowledge and retain information in AI conversations
Ready-to-paste prompt
Ask the AI to recall a previous conversation topic, such as 'What were we discussing about project X yesterday?'
Heads up: Before using basic-memory, ensure you have Python installed and configured on your system, as the tool is built using Python and may require specific version dependencies
Saves to your device
Use with Claude
New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

⚡ Runs out of the box

A prompt/skill package — nothing to install beyond adding it to your AI tool.

Try it instantly — no install
Claude Code
mkdir -p ~/.claude/skills/basic-memory && curl -fsSL https://workflowstacks.com/api/skills/basic-memory/claude-skill -o ~/.claude/skills/basic-memory/SKILL.md
Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)
claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How basic-memory — Persistent AI chats that keep your project context works
Codeflow
Free to inspect

Basic-memory — Persistent AI chats that keep your project context is a very large Python project (~189k lines across 707 code files, plus 545 test files). You install it into your AI tool with one command; there is nothing to run yourself. Last commit this month, AGPL-3.0 license, has a test suite.

Size
Very large codebase
~189k lines · 707 code files · days to read — use, don't read
Setup
Install as a skill / plugin
Add it to Claude Code (or your AI tool) with one command — 49 skills inside. Nothing to run yourself.
Runs on
Inside your AI tool
Helper scripts use Python · Docker · needs API keys
Python 91%HTML 6%TypeScript 2%
Where to start reading
  1. 1
    README.md
    Start here — what it does and how to install it
  2. 2
    AGENTS.md
    The instructions the AI actually follows
  3. 3
    .env.example
    The API keys and settings you must provide
  4. 4
    src/basic_memory/__init__.py
    Inside src/ — the main logic begins here
What's in each folder
src/Core code — the actual logic487 files
skills/Prompts, skills & agent definitions26 files
integrations/Sub-packages / plugins168 files
plugins/Sub-packages / plugins69 files
docs/Documentation37 files
test-int/Folder191 files
benchmarks/Evaluations & benchmarks154 files
scripts/Helper scripts10 files
READMEHas testsDocumentedCI checksDocker readyAGPL-3.0 licenseUpdated this month
Quick Actions
Details
Creator
basicmachines-co
Language
Python
Category
mcp-server
Published
12/2/2024

Are you the creator of this tool? and earn 85% of every sale.

Show it off in your README:

Featured on WorkflowStacks
[![Featured on WorkflowStacks](https://workflowstacks.com/api/badge/basic-memory.svg)](https://workflowstacks.com/skills/basic-memory?utm_source=github&utm_medium=badge)
🔥 Hot this week, in your inbox
Skills like this, every Monday.

The five fastest-growing open-source AI skills, ranked by GitHub star growth. One email a week, unsubscribe anytime.

Do this with a working workflow

Pages we wrote and tested that put a skill like this to work — importable n8n templates, outcome guides and Claude Desktop configs.