Memento MCP

Name: Memento MCP
Author: gannonh

gannonh

Get started Repository

Knowledge graph memory for LLMs built on Neo4j, with semantic search and temporal awareness for long-term recall.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add memento --env NEO4J_URI='<NEO4J_URI>' --env NEO4J_USERNAME='<NEO4J_USERNAME>' --env NEO4J_PASSWORD='<NEO4J_PASSWORD>' --env DEBUG='<DEBUG>' --env MEMORY_STORAGE_TYPE='<MEMORY_STORAGE_TYPE>' --env NEO4J_DATABASE='<NEO4J_DATABASE>' --env NEO4J_SIMILARITY_FUNCTION='<NEO4J_SIMILARITY_FUNCTION>' --env NEO4J_VECTOR_DIMENSIONS='<NEO4J_VECTOR_DIMENSIONS>' --env NEO4J_VECTOR_INDEX='<NEO4J_VECTOR_INDEX>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx memento-mcp

~/.codex/config.toml

[mcp_servers.memento]
command = "npx"
args = ["memento-mcp"]
env = { NEO4J_URI = "<NEO4J_URI>", NEO4J_USERNAME = "<NEO4J_USERNAME>", NEO4J_PASSWORD = "<NEO4J_PASSWORD>", DEBUG = "<DEBUG>", MEMORY_STORAGE_TYPE = "<MEMORY_STORAGE_TYPE>", NEO4J_DATABASE = "<NEO4J_DATABASE>", NEO4J_SIMILARITY_FUNCTION = "<NEO4J_SIMILARITY_FUNCTION>", NEO4J_VECTOR_DIMENSIONS = "<NEO4J_VECTOR_DIMENSIONS>", NEO4J_VECTOR_INDEX = "<NEO4J_VECTOR_INDEX>", OPENAI_API_KEY = "<OPENAI_API_KEY>" }

# codex mcp add memento --env NEO4J_URI='<NEO4J_URI>' --env NEO4J_USERNAME='<NEO4J_USERNAME>' --env NEO4J_PASSWORD='<NEO4J_PASSWORD>' --env DEBUG='<DEBUG>' --env MEMORY_STORAGE_TYPE='<MEMORY_STORAGE_TYPE>' --env NEO4J_DATABASE='<NEO4J_DATABASE>' --env NEO4J_SIMILARITY_FUNCTION='<NEO4J_SIMILARITY_FUNCTION>' --env NEO4J_VECTOR_DIMENSIONS='<NEO4J_VECTOR_DIMENSIONS>' --env NEO4J_VECTOR_INDEX='<NEO4J_VECTOR_INDEX>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx memento-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "memento": {
      "command": "npx",
      "args": [
        "memento-mcp"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
        "DEBUG": "<DEBUG>",
        "MEMORY_STORAGE_TYPE": "<MEMORY_STORAGE_TYPE>",
        "NEO4J_DATABASE": "<NEO4J_DATABASE>",
        "NEO4J_SIMILARITY_FUNCTION": "<NEO4J_SIMILARITY_FUNCTION>",
        "NEO4J_VECTOR_DIMENSIONS": "<NEO4J_VECTOR_DIMENSIONS>",
        "NEO4J_VECTOR_INDEX": "<NEO4J_VECTOR_INDEX>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "memento": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "memento-mcp"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
        "DEBUG": "<DEBUG>",
        "MEMORY_STORAGE_TYPE": "<MEMORY_STORAGE_TYPE>",
        "NEO4J_DATABASE": "<NEO4J_DATABASE>",
        "NEO4J_SIMILARITY_FUNCTION": "<NEO4J_SIMILARITY_FUNCTION>",
        "NEO4J_VECTOR_DIMENSIONS": "<NEO4J_VECTOR_DIMENSIONS>",
        "NEO4J_VECTOR_INDEX": "<NEO4J_VECTOR_INDEX>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "memento": {
      "command": "npx",
      "args": [
        "memento-mcp"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
        "DEBUG": "<DEBUG>",
        "MEMORY_STORAGE_TYPE": "<MEMORY_STORAGE_TYPE>",
        "NEO4J_DATABASE": "<NEO4J_DATABASE>",
        "NEO4J_SIMILARITY_FUNCTION": "<NEO4J_SIMILARITY_FUNCTION>",
        "NEO4J_VECTOR_DIMENSIONS": "<NEO4J_VECTOR_DIMENSIONS>",
        "NEO4J_VECTOR_INDEX": "<NEO4J_VECTOR_INDEX>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "memento": {
      "command": "npx",
      "args": [
        "memento-mcp"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
        "DEBUG": "<DEBUG>",
        "MEMORY_STORAGE_TYPE": "<MEMORY_STORAGE_TYPE>",
        "NEO4J_DATABASE": "<NEO4J_DATABASE>",
        "NEO4J_SIMILARITY_FUNCTION": "<NEO4J_SIMILARITY_FUNCTION>",
        "NEO4J_VECTOR_DIMENSIONS": "<NEO4J_VECTOR_DIMENSIONS>",
        "NEO4J_VECTOR_INDEX": "<NEO4J_VECTOR_INDEX>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "memento": {
      "command": "npx",
      "args": [
        "memento-mcp"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
        "DEBUG": "<DEBUG>",
        "MEMORY_STORAGE_TYPE": "<MEMORY_STORAGE_TYPE>",
        "NEO4J_DATABASE": "<NEO4J_DATABASE>",
        "NEO4J_SIMILARITY_FUNCTION": "<NEO4J_SIMILARITY_FUNCTION>",
        "NEO4J_VECTOR_DIMENSIONS": "<NEO4J_VECTOR_DIMENSIONS>",
        "NEO4J_VECTOR_INDEX": "<NEO4J_VECTOR_INDEX>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Environment variables

NEO4J_URI
NEO4J_USERNAME
NEO4J_PASSWORD
DEBUG
MEMORY_STORAGE_TYPE
NEO4J_DATABASE
NEO4J_SIMILARITY_FUNCTION
NEO4J_VECTOR_DIMENSIONS
NEO4J_VECTOR_INDEX
OPENAI_API_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related