Local-first AI memory server storing knowledge as Markdown files with semantic search and optional cloud sync.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent ā or use 1-click editor setup below.
We ran the install command below but it didn't respond within our test window ā this can mean a slow first-time install rather than a real problem.
npx -y skillsNo response to initialize.
This is an experimental automated check and can have false negatives ā missing environment variables, a slow cold install, etc. It doesnāt necessarily mean somethingās wrong. Last checked 1mo ago.
š” Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Inspect callable tools, capabilities, and parameters exposed to AI agents by Basic Memory.
write_noteCallable MCP tool function
read_noteCallable MCP tool function
edit_noteCallable MCP tool function
move_noteCallable MCP tool function
search_notesCallable MCP tool function
recent_activityCallable MCP tool function
Claude, Codex, or Cursor connected in 30 seconds. No Python, no JSON, no
terminal. $15.00/mo locked in for life (12.50/mo yearly pricing). 7-day free
trial ā cancel any time before day 7 if it's not for you. Beta pricing ā
sign up now and your rate never goes up. OSS users: code BMFOSS takes
another 20% off for 3 months.
Give your team a single, shared cloud workspace. Knowledge isn't confined to one person ā anything a teammate writes is immediately available to everyone else and to their AI assistants. Edit a note together in real time, hand work off between humans and agents, and build one connected knowledge base instead of scattered copies. Same pricing - start with one user and add more as needed.
Pick up right where you left off ā in Claude, Codex, Cursor, ChatGPT, or anything that speaks MCP. Your knowledge lives as Markdown files that both you and your AI can read, write, and search.
Pick the path that fits you. Both run the same product on the same Markdown.
| āļø Ā Cloud | š» Ā Local install |
|---|---|
|
30 seconds. Sign up, connect your AI client, done.
$15.00/mo locked for life Ā· 7-day free trial Ā· cancel any time |
2 minutes. Install, configure your AI client, run.
For Postgres deployments that store semantic vectors in Milvus, install the first-party optional extra instead: |
Basic Memory changed my whole relationship with LLMs. I switched from GPT and Gemini to exclusively Claude and Claude Code because of this integration and am completely revamping all our company's processes around a Basic Memory workflow.
ā Alex, TrainerDay
Basic Memory is the missing 'wow' factor in AI chatbots. Now I can't imagine Claude or Claude Code without it.
ā Caleb, Caleb Picker Consulting
I don't code without Basic Memory anymore. It's such a time saver to be able to refer to projects I don't currently have active and keep a running log of all my learnings and ProTips.
ā @groksrc, Developer
More on basicmemory.com.
The hosted version of Basic Memory. Same product, same Markdown files, same MCP tools ā we just host the database, run the sync, and put it on your phone.
Built on WorkOS AuthKit, Neon Postgres, and Tigris S3.
$15.00/mo, locked in for the life of your subscription (regular price $19). Sign up during beta and the rate never goes up ā as long as you stay subscribed, you keep the price. One plan, no tiers, no surprise upgrades. Unlimited notes, unlimited projects, every feature.
BMFOSS for another 20% off for 3 months (~$11.40/mo).Start your 7-day free trial ā
| Cloud | Local | |
|---|---|---|
| Setup time | 30 seconds | 2 minutes (requires Python) |
| Cost | $15.00/mo, locked for life (7-day trial) | Free |
| Storage | We host (Tigris S3) | Your disk |
| Cross-device sync | Built in | Manual (Git, Syncthing, etc.) |
| Mobile access | Yes (web + app) | No |
| Air-gapped | No | Yes |
| Your data stays yours | Yes ā export anytime | Yes ā already there |
| Source code | AGPL-3.0 | AGPL-3.0 |
| Snapshots & backups | Built in | Roll your own |
Both paths use the same OSS engine and the same Markdown files. There's no lock-in either way ā flip between them when your needs change.
| Client | Transport | Notes |
|---|---|---|
| Cloud web app | https | Sign in at basicmemory.com ā no install |
| Claude Desktop | stdio/https | macOS / Windows / Linux |
| Claude Code | stdio/https | claude mcp add |
| Codex | stdio/https | OpenAI's coding agent |
| Cursor | stdio/https | .cursor/mcp.json |
| VS Code | stdio/https | Native MCP support |
| ChatGPT | https | Custom GPT actions (search / fetch) |
| Obsidian | ā | Reads/writes the same Markdown directly |
| Anything MCP | stdio/https | If it speaks MCP, it works |
This repository is also the canonical home for Basic Memory's host-native agent packages. The core Python package, Claude Code plugin, shared skills, Hermes plugin, and OpenClaw plugin all ship from the same source tree.
Maintainers can verify the whole consolidated surface from the repo root:
Package-local justfiles are also available when working inside one host:
The Claude Code plugin is the bridge between Claude's working memory and Basic
Memory ā session-start briefings, pre-compaction checkpoints, an opt-in capture
output style, and /basic-memory:bm-setup Ā· :remember Ā· :share Ā· :status.
Connect the Basic Memory MCP server first ā see Connect your AI client. The plugin's hooks and skills call it, so it's a hard prerequisite. Then install the plugin:
That registers the marketplace and installs the plugin through Claude Code. Add
--scope project to declare both in the repository's settings for a team, or
--dry-run to see the underlying claude plugin commands without running them.
Source: plugins/claude-code.
Framework-agnostic SKILL.md files live in skills/. If your
Skills CLI supports repository subdirectory sources:
If your installed Skills CLI cannot load that source, update the CLI or copy
the memory-* directories from skills/ into your agent's skills directory.
Hermes keeps its native plugin shape under integrations/hermes:
Factual signals from GitHub, npm, and our automated checks ā not a rating.
No reviews yet ā be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/basicmachines-co-basic-memory)<a href="https://allmcps.com/mcp/basicmachines-co-basic-memory"><img src="https://allmcps.com/api/badge/basicmachines-co-basic-memory?style=directory" alt="Basic Memory on AllMCPs" /></a>