Client configuration

Claude Code configuration

Add the server with the claude mcp add command. See Connect Claude Code to tools via MCP for more details.

See Find your MCP server URL to retrieve your instance’s URL.

claude mcp add --transport http neo4j-mcp https://<instance-id>.mcp-instances.neo4j.io

This requires the Neo4j MCP server executable to be available on your system, installed using one of these options: Homebrew or manual installation.

claude mcp add neo4j-mcp \
  --env NEO4J_MCP_URI=bolt://localhost:7687 \
  --env NEO4J_MCP_USERNAME=neo4j \
  --env NEO4J_MCP_PASSWORD=password \
  --env NEO4J_MCP_DATABASE=neo4j \
  --env NEO4J_MCP_READ_ONLY=true \
  -- neo4j-mcp

This requires uvx to be available on your PATH. The server is downloaded from PyPI automatically, with no separate installation step.

claude mcp add neo4j-mcp \
  --env NEO4J_MCP_URI=bolt://localhost:7687 \
  --env NEO4J_MCP_USERNAME=neo4j \
  --env NEO4J_MCP_PASSWORD=password \
  --env NEO4J_MCP_DATABASE=neo4j \
  --env NEO4J_MCP_READ_ONLY=true \
  -- python -m neo4j_mcp_server

Alternatively, edit the .mcp.json file in your project root directly. This uses the same format as the Claude Desktop mcpServers configuration below.

VSCode configuration

Create / edit mcp.json:

See Find your MCP server URL to retrieve your instance’s URL.

{
  "servers": {
    "neo4j-mcp": {
      "type": "http",
      "url": "https://<instance-id>.mcp-instances.neo4j.io"
    }
  }
}

This requires the Neo4j MCP server executable to be available on your system, installed using one of these options: Homebrew or manual installation.

{
  "servers": {
    "neo4j-mcp": {
      "type": "stdio",
      "command": "neo4j-mcp",
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

This requires uvx to be available on your PATH. The server is downloaded from PyPI automatically, with no separate installation step.

{
  "servers": {
    "neo4j-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["neo4j-mcp-server"],
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

Also see Add and manage MCP servers in VS Code.

Cursor configuration

Create / edit .cursor/mcp.json in your project (or ~/.cursor/mcp.json for a global configuration). See Model Context Protocol in the Cursor documentation for more details.

See Find your MCP server URL to retrieve your instance’s URL.

{
  "mcpServers": {
    "neo4j-mcp": {
      "url": "https://<instance-id>.mcp-instances.neo4j.io"
    }
  }
}

This requires the Neo4j MCP server executable to be available on your system, installed using one of these options: Homebrew or manual installation.

{
  "mcpServers": {
    "neo4j-mcp": {
      "command": "neo4j-mcp",
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

This requires uvx to be available on your PATH. The server is downloaded from PyPI automatically, with no separate installation step.

{
  "mcpServers": {
    "neo4j-mcp": {
      "command": "uvx",
      "args": ["neo4j-mcp-server"],
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

Claude Desktop configuration

Configure Claude for desktop for all MCP servers you want to use. Open your Claude for desktop App configuration in a text editor. Find the files at:

  • (MacOS/Linux) ~/Library/Application Support/Claude/claude_desktop_config.json

  • (Windows) $env:AppData\Claude\claude_desktop_config.json

Make sure to create the file if it doesn’t exist.

Add Neo4j MCP under the mcpServers key:

See Find your MCP server URL to retrieve your instance’s URL.

This requires npx to be available on your system, which is included with Node.js. See Download Node.js for installation instructions.

 
{
  "mcpServers": {
    "neo4j-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<instance-id>.mcp-instances.neo4j.io"
      ]
    }
  }
}

This requires the Neo4j MCP server executable to be available on your system, installed using one of these options: Homebrew or manual installation.

{
  "mcpServers": {
    "neo4j-mcp": {
      "type": "stdio",
      "command": "neo4j-mcp",
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

This requires uvx to be available on your PATH. The server is downloaded from PyPI automatically, with no separate installation step.

{
  "mcpServers": {
    "neo4j-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["neo4j-mcp-server"],
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}