basic-memory

Name: basic-memory
Author: basicmachines-co

Community

MCP server by basicmachines-co · updated yesterday · ★ 4.3k

Score 91

Local-first knowledge management with bi-directional LLM sync via Markdown files. basic-memory is a community project by basicmachines-co, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit in the past day

Licence

AGPL-3.0: copyleft, check the terms before using it in a product

Quality

Clear description, published package or server URL, 4,279 stars, original repository

Security

Not checked yet. What we check

Install basic-memory

Built from the published package, never by AI

claude mcp add basic-memory -- uvx basic-memory

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install basic-memory in Claude Code

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory"
      ]
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install basic-memory in Claude Desktop

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install basic-memory in Cursor

{
  "servers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory"
      ]
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install basic-memory in VS Code

codex mcp add basic-memory -- uvx basic-memory

Step-by-step: install basic-memory in Codex

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory"
      ]
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install basic-memory in Antigravity CLI

gemini mcp add basic-memory uvx basic-memory

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install basic-memory in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the basic-memory block.

Alternatives to basic-memory

All alternatives →

Power BI Authoring MCP Server (Local) microsoft

The Power BI Authoring MCP server lets an AI agent create and change Power BI semantic models.

AAA Local 7.1k/wk

Agent-Native AnalyticsBuilderIO

Agent-Native Amplitude/Mixpanel - connect data sources, prompt for charts

AAA Remote 7.4k

Google Ads + Meta Ads + SEO/GEO MCPirinabuht12-oss

Google Ads, Meta Ads, Google Analytics (GA4) & Search Console MCP server by Ryze AI

AAA Remote 5.3k

Excel MCP Serverharis-musa

Create and edit Excel files with AI: charts, PivotTables, formulas. No Excel needed.

AAA Local 4.2k

MCP Gateway HarrisonCN

MCP gateway for AI models (OpenAI, Grok, DeepSeek, Claude and other function-calling LLMs) and for web pages and apps: one authenticated, observable endpoint in front of your MCP servers with routing, scopes, rate limits and metrics.

AAC Local 29k/wk

Deepnote MCP deepnote

MCP server for AI-assisted Deepnote notebook creation and manipulation

AAA Local 3.0k

basic-memory vs Power BI Authoring MCP Server (Local) basic-memory vs Agent-Native Analytics basic-memory vs Google Ads + Meta Ads + SEO/GEO MCP

basic-memory: common questions

How do I install basic-memory?

In Claude Code run claude mcp add basic-memory -- uvx basic-memory. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is basic-memory the official server?

basic-memory is a community project by basicmachines-co, not verified by a company domain.

Is basic-memory free?

The code is published under the AGPL-3.0 licence. The service it connects to may have its own pricing.

Is basic-memory safe to use?

It scores 91 of 100. Grades: maintenance A, licence C, quality A. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to basic-memory?

Does basic-memory work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.