mcp-server

Basic-Memory: AI that Remembers

Name: Basic-Memory: AI that Remembers
Author: basicmachines-co

Get AI conversations that recall context, ideal for founders seeking efficient knowledge management

intermediate⏱ 30 minutes💵 Free

3,514 stars239 forksPythonUpdated 7/25/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: AI that Remembers works

Codeflow

Free to inspect

Basic-Memory: AI that Remembers is a very large Python project (~186k lines across 689 code files, plus 527 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

~186k lines · 689 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
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
.env.example
The API keys and settings you must provide
4
src/basic_memory/__init__.py
Inside src/ — the main logic begins here

What's in each folder

src/Core code — the actual logic471 files

skills/Prompts, skills & agent definitions26 files

integrations/Sub-packages / plugins168 files

plugins/Sub-packages / plugins69 files

docs/Documentation37 files

test-int/Folder189 files

benchmarks/Evaluations & benchmarks154 files

scripts/Helper scripts10 files

READMEHas testsDocumentedCI checksDocker readyAGPL-3.0 licenseUpdated this month

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.

Quick Actions

Details

Creator

basicmachines-co

Language

Python