Skip to content
MCP server

EvolutionDB Long-Term Memory

Persistent long-term memory for Claude Desktop / Claude Code, backed by EvolutionDB.

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

About EvolutionDB Long-Term Memory

EvolutionDB Long-Term Memory is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add evolutiondb-memory --env EVOSQL_PASSWORD='<EVOSQL_PASSWORD>' --env MCP_USER_ID='<MCP_USER_ID>' -- uvx mcp-server-evolutiondb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "evolutiondb-memory": {
      "command": "uvx",
      "args": [
        "mcp-server-evolutiondb"
      ],
      "env": {
        "EVOSQL_PASSWORD": "<EVOSQL_PASSWORD>",
        "MCP_USER_ID": "<MCP_USER_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "evolutiondb-memory": {
      "command": "uvx",
      "args": [
        "mcp-server-evolutiondb"
      ],
      "env": {
        "EVOSQL_PASSWORD": "<EVOSQL_PASSWORD>",
        "MCP_USER_ID": "<MCP_USER_ID>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "evolutiondb-memory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-evolutiondb"
      ],
      "env": {
        "EVOSQL_PASSWORD": "<EVOSQL_PASSWORD>",
        "MCP_USER_ID": "<MCP_USER_ID>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "evolutiondb-memory": {
      "command": "uvx",
      "args": [
        "mcp-server-evolutiondb"
      ],
      "env": {
        "EVOSQL_PASSWORD": "<EVOSQL_PASSWORD>",
        "MCP_USER_ID": "<MCP_USER_ID>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "evolutiondb-memory": {
      "command": "uvx",
      "args": [
        "mcp-server-evolutiondb"
      ],
      "env": {
        "EVOSQL_PASSWORD": "<EVOSQL_PASSWORD>",
        "MCP_USER_ID": "<MCP_USER_ID>"
      }
    }
  }
}

Configuration

  • EVOSQL_HOSTHostname where EvolutionDB is reachable on the PostgreSQL wire (port 5433).
  • EVOSQL_PORTEvolutionDB's PostgreSQL-protocol port.
  • EVOSQL_USERDatabase user.
  • EVOSQL_PASSWORDDatabase password.
  • EVOSQL_DATABASEDatabase name to use.
  • MCP_USER_IDSticky namespace identifier for every memory Claude writes through this server. Server-side override — the LLM cannot fragment your namespace by inventing other IDs.Required
  • MCP_STORE_PREFIXPrefix for the auto-created MEMORY STORE / ENTITY STORE catalog objects.

Pricing

Open source

EvolutionDB Long-Term Memory FAQ

Is EvolutionDB Long-Term Memory free?

Yes. EvolutionDB Long-Term Memory is open source, so you can use and self-host it for free.

How do I add EvolutionDB Long-Term Memory to Claude Code?

Run this command in your terminal: claude mcp add evolutiondb-memory --env EVOSQL_PASSWORD='<EVOSQL_PASSWORD>' --env MCP_USER_ID='<MCP_USER_ID>' -- uvx mcp-server-evolutiondb

What are the best alternatives to EvolutionDB Long-Term Memory?

The closest alternatives to EvolutionDB Long-Term Memory are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to EvolutionDB Long-Term Memory

  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