mcpbeat Sign in

Basic Memory MCP Server

by basicmachines-co Your server? Claim it
local only

Basic Memory runs on your own machine — the client starts it, so there is no endpoint to ping. 7 255 installs a week from pypi. Last commit 16 Sep 2026.

Local-first knowledge management with bi-directional LLM sync via Markdown files.

Installs per day peak 6 134 · avg 1 811 · -62% w/w
a month agotoday
7 255
Installs / week
pypi · basic-memory
4016
Stars
62 open issues
16 Sep 2026
Last commit
0 releases in 90 days
AGPL-3.0
License
Python

What the code does

We read the source, 7 h ago · rules 3dff92dd89df

A tool parameter reaches a dangerous call

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

A tool parameter reaches a dangerous call bm_context.url → src/basic_memory/cli/commands/hook.py:847, bm_context.url → src/basic_memory/cli/commands/hook.py:848, bm_context.url → src/basic_memory/cli/commands/hook.py:873 и ещё 2
        result = subprocess.run(
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] src/basic_memory/migration_loop.py:1
этот файл ставится пользователю, но в репозитории его нет
Runs an external command [пакет] src/basic_memory/cli/commands/cloud/rclone_installer.py:42, src/basic_memory/cli/auto_update.py:108, plugins/claude-code/hooks/pre_compact.py:53 и ещё 15
        result = subprocess.run(command, capture_output=True, text=True, check=check)
Dumps the whole environment [пакет] integrations/openclaw/integration/bm-client.integration.test.ts:125
      for (const [key, value] of Object.entries(process.env)) {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add basic-memory -- uvx basic-memory
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "basic-memory": {
      "args": [
        "basic-memory"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.basic-memory]
command = "uvx"
args = ["basic-memory"]
.cursor/mcp.json
{
  "mcpServers": {
    "basic-memory": {
      "args": [
        "basic-memory"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "basic-memory": {
      "args": [
        "basic-memory"
      ],
      "command": "uvx"
    }
  }
}

Alternatives to Basic Memory

same job, measured the same way
Dense Knowledge
by lucky44k

Local-first MCP memory server for persistent LLM knowledge with BM25 retrieval.

126 installs/wk local only
I
Bookmark Lens
by cornelcroi

Local-first bookmark management with semantic search and AI-powered organization

107 installs/wk local only
Superlocalmemory
by varun369

Local-first AI memory with knowledge graphs and hybrid search. 17+ AI tools via MCP. Free.

627 installs/wk local only
Memento
by scrypster

Persistent memory for AI tools. Local-first knowledge graph with hybrid search.

local only
Cortex
by abbacusgroup

Persistent knowledge system with OWL-RL reasoning and 22 MCP tools. Local-first.

260 installs/wk local only
LINZA
by semiotronika

Local-first MCP sidecar for Markdown artifacts, review intents, and supervised knowledge growth.

152 installs/wk local only
IWE
by iwe-org

Markdown knowledge base as agent memory. Runs against the notes directory it is started in.

255 installs/wk local only
Kogcat MCP
by kogcat

Local-first judgment layer: counter-examples & blind spots from your own knowledge base.

126 installs/wk local only

Basic Memory — questions

Answers built from our own checks of this server.

Why is there no uptime for Basic Memory?
Basic Memory runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package basic-memory was installed 7 255 times last week.
How do I connect Basic Memory?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls basic-memory straight from pypi; nothing to host, nothing to sign up for.
How many people use Basic Memory?
The pypi package basic-memory was installed 7 255 times in the last week. Week over week that is -62%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Basic Memory open source?
Yes — it is published under the AGPL-3.0 licence, written in Python, 4 016 stars on GitHub and 62 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.