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. 15 282 installs a week from pypi. Last commit 6 Nov 2026.

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

Installs per day peak 7 869 · avg 2 100 · -24% w/w
a month agotoday
15 282
Installs / week
pypi · basic-memory
4 515
Stars
70 open issues
6 Nov 2026
Last commit
from GitHub
AGPL-3.0
License
Python

What the code does

We read the source, 4 h ago · rules 995398eba69f

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 и ещё 3
        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/cli/commands/format.py:1
этот файл ставится пользователю, но в репозитории его нет

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": {
      "command": "uvx",
      "args": [
        "basic-memory"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.basic-memory]
command = "uvx"
args = ["basic-memory"]
.cursor/mcp.json
{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "basic-memory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "basic-memory"
      ]
    }
  }
}

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.

145 installs/wk local only
B
Bookmark Lens
by cornelcroi

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

102 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.

452 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
Kogcat MCP
by kogcat

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

119 installs/wk local only
Memex
by evan-moon

Local-first second brain with semantic search. Markdown notes indexed by a local ML model.

51 installs/wk local only
IWE (iwe.md)
by iwe-org

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

656 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 15 282 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 in the form 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 15 282 times in the last week. Week over week that is -24%. 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 515 stars on GitHub and 70 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.