Quickstart

MCP for Aura

First, retrieve your instance’s MCP server URL:

  1. Under Instances in the left side navigation of the Aura Console, retrieve the ID of the Aura instance you would like to use with Neo4j MCP.

  2. Substitute the ID in the following template to get your MCP server URL: https://<INSTANCE_ID>.mcp-instances.neo4j.io.

For a visual walkthrough, or to copy the URL directly from the instance details, see Find your MCP server URL.

Then add Neo4j MCP to your client’s MCP configuration. For example, in VS Code, create or edit mcp.json:

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

See Client configuration for other client-specific configuration.

Self hosted

Installation

pip install neo4j-mcp-server

For a more comprehensive installation guide, see Installation.

Configuration

Add Neo4j MCP to your client’s MCP configuration. For example, in VS Code, create or edit mcp.json:

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

 
{
  "servers": {
    "neo4j": {
      "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"
      }
    }
  }
}

See Client configuration for other client-specific configuration and Configuration reference for the full list of configuration options.