A local-first AI memory system with hybrid search, MCP integration, and a knowledge graph.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add memory-vault --env DB_HOST='<DB_HOST>' --env DB_PORT='<DB_PORT>' --env DB_NAME='<DB_NAME>' --env DB_USER='<DB_USER>' --env DB_PASSWORD='<DB_PASSWORD>' -- docker run -i --rm -e DB_HOST -e DB_PORT -e DB_NAME -e DB_USER -e DB_PASSWORD ghcr.io/mihaibuilds/memory-vault-mcp:1.6.1~/.codex/config.toml
[mcp_servers.memory-vault]
command = "docker"
args = ["run", "-i", "--rm", "-e", "DB_HOST", "-e", "DB_PORT", "-e", "DB_NAME", "-e", "DB_USER", "-e", "DB_PASSWORD", "ghcr.io/mihaibuilds/memory-vault-mcp:1.6.1"]
env = { DB_HOST = "<DB_HOST>", DB_PORT = "<DB_PORT>", DB_NAME = "<DB_NAME>", DB_USER = "<DB_USER>", DB_PASSWORD = "<DB_PASSWORD>" }
# codex mcp add memory-vault --env DB_HOST='<DB_HOST>' --env DB_PORT='<DB_PORT>' --env DB_NAME='<DB_NAME>' --env DB_USER='<DB_USER>' --env DB_PASSWORD='<DB_PASSWORD>' -- docker run -i --rm -e DB_HOST -e DB_PORT -e DB_NAME -e DB_USER -e DB_PASSWORD ghcr.io/mihaibuilds/memory-vault-mcp:1.6.1~/.cursor/mcp.json
{
"mcpServers": {
"memory-vault": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DB_HOST",
"-e",
"DB_PORT",
"-e",
"DB_NAME",
"-e",
"DB_USER",
"-e",
"DB_PASSWORD",
"ghcr.io/mihaibuilds/memory-vault-mcp:1.6.1"
],
"env": {
"DB_HOST": "<DB_HOST>",
"DB_PORT": "<DB_PORT>",
"DB_NAME": "<DB_NAME>",
"DB_USER": "<DB_USER>",
"DB_PASSWORD": "<DB_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"memory-vault": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DB_HOST",
"-e",
"DB_PORT",
"-e",
"DB_NAME",
"-e",
"DB_USER",
"-e",
"DB_PASSWORD",
"ghcr.io/mihaibuilds/memory-vault-mcp:1.6.1"
],
"env": {
"DB_HOST": "<DB_HOST>",
"DB_PORT": "<DB_PORT>",
"DB_NAME": "<DB_NAME>",
"DB_USER": "<DB_USER>",
"DB_PASSWORD": "<DB_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"memory-vault": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DB_HOST",
"-e",
"DB_PORT",
"-e",
"DB_NAME",
"-e",
"DB_USER",
"-e",
"DB_PASSWORD",
"ghcr.io/mihaibuilds/memory-vault-mcp:1.6.1"
],
"env": {
"DB_HOST": "<DB_HOST>",
"DB_PORT": "<DB_PORT>",
"DB_NAME": "<DB_NAME>",
"DB_USER": "<DB_USER>",
"DB_PASSWORD": "<DB_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"memory-vault": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DB_HOST",
"-e",
"DB_PORT",
"-e",
"DB_NAME",
"-e",
"DB_USER",
"-e",
"DB_PASSWORD",
"ghcr.io/mihaibuilds/memory-vault-mcp:1.6.1"
],
"env": {
"DB_HOST": "<DB_HOST>",
"DB_PORT": "<DB_PORT>",
"DB_NAME": "<DB_NAME>",
"DB_USER": "<DB_USER>",
"DB_PASSWORD": "<DB_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"memory-vault": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DB_HOST",
"-e",
"DB_PORT",
"-e",
"DB_NAME",
"-e",
"DB_USER",
"-e",
"DB_PASSWORD",
"ghcr.io/mihaibuilds/memory-vault-mcp:1.6.1"
],
"env": {
"DB_HOST": "<DB_HOST>",
"DB_PORT": "<DB_PORT>",
"DB_NAME": "<DB_NAME>",
"DB_USER": "<DB_USER>",
"DB_PASSWORD": "<DB_PASSWORD>"
}
}
}
}Environment variables
DB_HOSTDB_PORTDB_NAMEDB_USERDB_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.