How to connect Neo4j to Cursor

Checked against Cursor's documentation on Oct 26, 2026. Commands and config blocks are generated from the same install data as each listing page.

1. 1. Check what you need

   Cursor launches this server through uvx, which uv provides, so run the version check before you edit any config.

   uv --version

   Copy

   • It needs NEO4J_URI, NEO4J_USERNAME and NEO4J_PASSWORD (next step).

2. 2. Get NEO4J_URI, NEO4J_USERNAME and NEO4J_PASSWORD

   Each of these values is required. Have them ready now so the config and the shell export can use them straight away.

   • NEO4J_URI (required): Neo4j connection URI.
   • NEO4J_USERNAME (required): Neo4j username.
   • NEO4J_PASSWORD (required): Neo4j password.

3. 3. Add MCP Neo4j Cypher to Cursor

   A single JSON entry defines the server, and each value is referenced through the ${env:NAME} form so nothing sensitive is written into the file. The shell block supplies the real values.

   {
     "mcpServers": {
       "mcp-neo4j-cypher": {
         "command": "uvx",
         "args": [
           "mcp-neo4j-cypher@0.5.1"
         ],
         "env": {
           "NEO4J_URI": "${env:NEO4J_URI}",
           "NEO4J_USERNAME": "${env:NEO4J_USERNAME}",
           "NEO4J_PASSWORD": "${env:NEO4J_PASSWORD}"
         }
       }
     }
   }

   Copy

   export NEO4J_URI="paste-your-value-here"
   export NEO4J_USERNAME="paste-your-value-here"
   export NEO4J_PASSWORD="paste-your-value-here"

   Copy

   • Cursor expands ${env:NAME} from its own environment, so the variable has to be set where Cursor starts.

4. 4. Restart or reload if it does not appear

   If MCP Neo4j Cypher does not appear, read this step for the docs' guidance on restarts and on approving tool use.

   • The docs do not say whether editing mcp.json needs a restart. They tell you to restart Cursor after updating files of a custom local server.
   • Cursor asks for approval before an agent uses an MCP tool unless you allowlist it.