Semantic Memory MCP

Name: Semantic Memory MCP
Author: Josh Stevenson

Josh Stevenson

MCP server wrapping semantic-memory — local-first knowledge management with evidence-scored retrieval, contradiction detection, and adaptive routing

Setup

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

Add to Cursor Add to VS Code

claude mcp add semantic-memory --env MEMORY_DIR='<MEMORY_DIR>' --env TOOL_PROFILE='<TOOL_PROFILE>' -- npx -y @recursiveintell/semantic-memory-mcp --memory-dir '{{config.MEMORY_DIR}}' --tool-profile '{{config.TOOL_PROFILE}}'

~/.codex/config.toml

[mcp_servers.semantic-memory]
command = "npx"
args = ["-y", "@recursiveintell/semantic-memory-mcp", "--memory-dir", "{{config.MEMORY_DIR}}", "--tool-profile", "{{config.TOOL_PROFILE}}"]
env = { MEMORY_DIR = "<MEMORY_DIR>", TOOL_PROFILE = "<TOOL_PROFILE>" }

# codex mcp add semantic-memory --env MEMORY_DIR='<MEMORY_DIR>' --env TOOL_PROFILE='<TOOL_PROFILE>' -- npx -y @recursiveintell/semantic-memory-mcp --memory-dir '{{config.MEMORY_DIR}}' --tool-profile '{{config.TOOL_PROFILE}}'

~/.cursor/mcp.json

{
  "mcpServers": {
    "semantic-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@recursiveintell/semantic-memory-mcp",
        "--memory-dir",
        "{{config.MEMORY_DIR}}",
        "--tool-profile",
        "{{config.TOOL_PROFILE}}"
      ],
      "env": {
        "MEMORY_DIR": "<MEMORY_DIR>",
        "TOOL_PROFILE": "<TOOL_PROFILE>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "semantic-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@recursiveintell/semantic-memory-mcp",
        "--memory-dir",
        "{{config.MEMORY_DIR}}",
        "--tool-profile",
        "{{config.TOOL_PROFILE}}"
      ],
      "env": {
        "MEMORY_DIR": "<MEMORY_DIR>",
        "TOOL_PROFILE": "<TOOL_PROFILE>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "semantic-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@recursiveintell/semantic-memory-mcp",
        "--memory-dir",
        "{{config.MEMORY_DIR}}",
        "--tool-profile",
        "{{config.TOOL_PROFILE}}"
      ],
      "env": {
        "MEMORY_DIR": "<MEMORY_DIR>",
        "TOOL_PROFILE": "<TOOL_PROFILE>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "semantic-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@recursiveintell/semantic-memory-mcp",
        "--memory-dir",
        "{{config.MEMORY_DIR}}",
        "--tool-profile",
        "{{config.TOOL_PROFILE}}"
      ],
      "env": {
        "MEMORY_DIR": "<MEMORY_DIR>",
        "TOOL_PROFILE": "<TOOL_PROFILE>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "semantic-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@recursiveintell/semantic-memory-mcp",
        "--memory-dir",
        "{{config.MEMORY_DIR}}",
        "--tool-profile",
        "{{config.TOOL_PROFILE}}"
      ],
      "env": {
        "MEMORY_DIR": "<MEMORY_DIR>",
        "TOOL_PROFILE": "<TOOL_PROFILE>"
      }
    }
  }
}

Environment variables

MEMORY_DIR
TOOL_PROFILE

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

Setup

Environment variables

Related