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_URI=bolt://localhost:7687 \
  --env NEO4J_USERNAME=neo4j \
  --env NEO4J_PASSWORD=password \
  --env NEO4J_DATABASE=neo4j \
  --env NEO4J_READ_ONLY=true \
  -- neo4j-mcp

This requires the Neo4j MCP server to have been installed using PyPI. See Install with PyPI.

On some systems the Python 3 interpreter is named python3 instead of python. Use whichever is available in your environment.

 
claude mcp add neo4j-mcp \
  --env NEO4J_URI=bolt://localhost:7687 \
  --env NEO4J_USERNAME=neo4j \
  --env NEO4J_PASSWORD=password \
  --env NEO4J_DATABASE=neo4j \
  --env NEO4J_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_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password",
        "NEO4J_DATABASE": "neo4j",
        "NEO4J_READ_ONLY": "true",
        "NEO4J_TELEMETRY": "false",
        "NEO4J_LOG_LEVEL": "info",
        "NEO4J_LOG_FORMAT": "text",
        "NEO4J_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

This requires the Neo4j MCP server to have been installed using PyPI. See Install with PyPI.

On some systems the Python 3 interpreter is named python3 instead of python. Use whichever is available in your environment.

 
{
  "servers": {
    "neo4j-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "neo4j_mcp_server"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password",
        "NEO4J_DATABASE": "neo4j",
        "NEO4J_READ_ONLY": "true",
        "NEO4J_TELEMETRY": "false",
        "NEO4J_LOG_LEVEL": "info",
        "NEO4J_LOG_FORMAT": "text",
        "NEO4J_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_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password",
        "NEO4J_DATABASE": "neo4j",
        "NEO4J_READ_ONLY": "true",
        "NEO4J_TELEMETRY": "false",
        "NEO4J_LOG_LEVEL": "info",
        "NEO4J_LOG_FORMAT": "text",
        "NEO4J_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

This requires the Neo4j MCP server to have been installed using PyPI. See Install with PyPI.

On some systems the Python 3 interpreter is named python3 instead of python. Use whichever is available in your environment.

 
{
  "mcpServers": {
    "neo4j-mcp": {
      "command": "python",
      "args": ["-m", "neo4j_mcp_server"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password",
        "NEO4J_DATABASE": "neo4j",
        "NEO4J_READ_ONLY": "true",
        "NEO4J_TELEMETRY": "false",
        "NEO4J_LOG_LEVEL": "info",
        "NEO4J_LOG_FORMAT": "text",
        "NEO4J_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_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password",
        "NEO4J_DATABASE": "neo4j",
        "NEO4J_READ_ONLY": "true",
        "NEO4J_TELEMETRY": "false",
        "NEO4J_LOG_LEVEL": "info",
        "NEO4J_LOG_FORMAT": "text",
        "NEO4J_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

This requires the Neo4j MCP server to have been installed using PyPI. See Install with PyPI.

On some systems the Python 3 interpreter is named python3 instead of python. Use whichever is available in your environment.

 
{
  "mcpServers": {
    "neo4j-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "neo4j_mcp_server"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password",
        "NEO4J_DATABASE": "neo4j",
        "NEO4J_READ_ONLY": "true",
        "NEO4J_TELEMETRY": "false",
        "NEO4J_LOG_LEVEL": "info",
        "NEO4J_LOG_FORMAT": "text",
        "NEO4J_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}