Skip to content
MCP server

Cuba Memorys

Persistent memory MCP server. 28 tools, BM25+MMR+OOD retrieval, tamper-evident audit…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.24.0
Listing updated
4 days ago

About Cuba Memorys

Cuba Memorys is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Persistent memory MCP server. 28 tools, BM25+MMR+OOD retrieval, tamper-evident audit, code graph.

Install

Run in a terminal

claude mcp add cuba-memorys --env DATABASE_URL='<DATABASE_URL>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- npx -y cuba-memorys

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cuba-memorys": {
      "command": "npx",
      "args": [
        "-y",
        "cuba-memorys"
      ],
      "env": {
        "DATABASE_URL": "<DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cuba-memorys": {
      "command": "npx",
      "args": [
        "-y",
        "cuba-memorys"
      ],
      "env": {
        "DATABASE_URL": "<DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "cuba-memorys": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cuba-memorys"
      ],
      "env": {
        "DATABASE_URL": "<DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cuba-memorys": {
      "command": "npx",
      "args": [
        "-y",
        "cuba-memorys"
      ],
      "env": {
        "DATABASE_URL": "<DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cuba-memorys": {
      "command": "npx",
      "args": [
        "-y",
        "cuba-memorys"
      ],
      "env": {
        "DATABASE_URL": "<DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}

Configuration

  • DATABASE_URLPostgreSQL connection URL (e.g. postgresql://user:pass@localhost:5432/brain)Required
  • CUBA_PROJECT_FILTERSet to 'off' to disable v0.8 project scoping filters (admin/debug only).
  • CUBA_SYNC_DIRDirectory used by cuba_sync export/import (default ./.cuba-memorys/).
  • CUBA_JUDGEcuba_juez backend selector: claude_cli | anthropic_api | heuristic | auto (default auto).
  • CUBA_JUEZ_CLISubprocess CLI used by ClaudeCodeJudge (default 'claude').
  • CUBA_JUEZ_MODELModel name passed to the judge backend (default 'claude-haiku-4-5').
  • ANTHROPIC_API_KEYAPI key for AnthropicApiJudge (only used when feature 'anthropic-api' is built in).
  • CUBA_REM_RELATION_BATCHIsolated entities the REM cycle scans for relations per run (default 5, 0 disables).
  • CUBA_RERANKER_PATHDirectory holding the bge-reranker ONNX model; enables cross-encoder reranking (+93% nDCG on GPU).
  • CUBA_RERANK_FIXED_SHAPEPad reranker batches to a constant 512 tokens. Defaults on for GPU builds, off on CPU.
  • DATABASE_URLPostgreSQL connection URL (e.g. postgresql://user:pass@localhost:5432/brain)Required

Pricing

Open source

Cuba Memorys FAQ

Is Cuba Memorys free?

Yes. Cuba Memorys is open source, so you can use and self-host it for free.

How do I add Cuba Memorys to Claude Code?

Run this command in your terminal: claude mcp add cuba-memorys --env DATABASE_URL='<DATABASE_URL>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- npx -y cuba-memorys

What are the best alternatives to Cuba Memorys?

The closest alternatives to Cuba Memorys are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to Cuba Memorys

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity