Basic Memory MCP server
io.github.basicmachines-co/basic-memory·v1.0.0·4.4k starsLocal-first knowledge management with bi-directional LLM sync via Markdown files.
4.4k stars19k downloads/wk
Reviews
Write oneNobody has reviewed Basic Memory yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Basic Memory tools (13, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
bm_contextBuild graph context from a starting note or pattern.
bm_deletewrite actionDelete one note or one directory.
bm_editEdit one existing note.
bm_findFind files by name, or notes by frontmatter.
bm_listList one directory level within the required project.
bm_manRead one manual page, search the manual, or list every page.
bm_moveMove one note or one directory.
bm_projectList or create projects, or show what changed in them.
bm_project_deletewrite actionDelete one project.
bm_readRead one note or file.
bm_schemaValidate, infer or diff note schemas.
bm_searchbm_writewrite actionCreate or replace one note.
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan719 source files scanned13/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 1 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (1)
- highShell command built from a string (injection risk)
exec.shell-concatbasic_memory-1.0.0/integrations/openclaw/commands/slash.ts: …}`) try { const output = execSync(`bash "${scriptPath}"`, { encoding: "ut…
How Basic Memory compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 75/100
- higher than 45% of 4,461 AI and agents servers
- Tools
- 13
- the typical AI and agents server has 6
- Tools that change things
- 23%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 4,425
- more than 95% of 2,713 AI and agents servers
- Downloads a week
- 18,630
- more than 95% of 1,554 AI and agents servers with a package
What its tools let an agent do: 10 read · 3 change
Release history: 3 versions in the registry since 2026-08-25, latest 2026-10-29, typically one every 58 days.
Install Basic Memory in Claude Code, Cursor or VS Code
claude mcp add basic-memory -- uvx basic-memory
What the publisher says
From the Basic Memory repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.basicmachines-co/basic-memory -->
Skip the install — try Basic Memory in the cloud
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.
Start free trial →
Basic Memory Teams is now available!
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.
Basic Memory
Your AI never forgets again.
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.
cross-encoder reranking for higher-quality vector and hybrid results.
- Local-first. Plain text on your disk. Forever.
- Two-way. AI and humans write to the same files; sync keeps them in step.
- A real knowledge graph. Observations and wikilinks compound into context.
- Semantic search. Find notes by meaning, not just keywords, with optional
(read-only, destructive, idempotent) so agents pick the right tool on demand — no wasted context trying things to see what they do.
- MCP-native. Works with every major AI client and IDE.
- Progressive tool discovery. Every tool is tagged with behavior hints
- Cloud, optional. Sync across devices when you want — never required.
Get started
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.
- Works in any browser
- Mobile, web, desktop
- Cross-device sync built in
- We handle hosting, backups, snapshots
$15.00/mo locked for life · 7-day free trial · cancel any time
Start free trial →
2 minutes. Install, configure your AI client, run.
- Free forever (AGPL-3.0)
- All data on your disk
- Air-gapped friendly
- Requires Python via uv
uv tool install basic-memory --prerelease=allowShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Grade history
- 2026-10-31restoreC → Bscore 75: Shell command built from a string (injection risk)
Basic Memory: common questions
- Is Basic Memory MCP server safe?
- Mostly: it is graded B (75/100). Read the Basic Memory safety report
- How do I install Basic Memory?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Basic Memory need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Basic Memory maintained?
- The last commit was 6 days ago (2026-10-30). The latest release is v1.0.0.
- What can I use instead of Basic Memory?
- Servers from other publishers that do the same job: IWE (iwe.md) MCP server, Agent Recall MCP server and Total Agent Memory MCP server. Compare all Basic Memory alternatives.
- How does Basic Memory compare with other AI and agents MCP servers?
- safety score 75/100 (higher than 45% of 4,461 AI and agents servers); tools 13 (the typical AI and agents server has 6); tools that change things 23% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Basic Memory
Same job from other publishers: the closest match first, then the best rated.
- IWE (iwe.md)Markdown knowledge base as agent memory. Runs against the notes directory it is started in.not reviewedEstablishedA
- Agent RecallCorrection-first agent memory. Precision KPI tracks if agents heed warnings. 5 layers, local-only.not reviewedEstablishedA
- Total Agent MemoryPersistent local memory for coding agents: temporal knowledge graph, procedural and episodic recallnot reviewedEstablishedA
- HOL GuardLocal-first AI agent security evidence and approval workflows through HOL Guard's stdio MCP server.not reviewedEstablishedA
- Agent-Native ChatMinimal chat-first app with durable threads, actions, and the app-agent loopnot reviewedEstablishedA