How to connect Neo4j to Claude Code

Checked against Claude Code'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

   uv provides uvx, the launcher for this server, so install it before you add anything to Claude Code.

   uv --version

   Copy

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

2. 2. Get NEO4J_URI, NEO4J_USERNAME and NEO4J_PASSWORD

   Every value here is required, so collect the connection address, the username and the password. Keep them private.

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

3. 3. Add MCP Neo4j Cypher to Claude Code

   Pick the user-scope command to register the server for all your projects, or use .mcp.json to define it for one project. The JSON version refers to each value through an environment variable, and the last block exports them.

   claude mcp add --transport stdio --env NEO4J_URI=YOUR_NEO4J_URI --env NEO4J_USERNAME=YOUR_NEO4J_USERNAME --env NEO4J_PASSWORD=YOUR_NEO4J_PASSWORD --scope user mcp-neo4j-cypher -- uvx mcp-neo4j-cypher@0.5.1

   Copy

   {
     "mcpServers": {
       "mcp-neo4j-cypher": {
         "command": "uvx",
         "args": [
           "mcp-neo4j-cypher@0.5.1"
         ],
         "env": {
           "NEO4J_URI": "${NEO4J_URI}",
           "NEO4J_USERNAME": "${NEO4J_USERNAME}",
           "NEO4J_PASSWORD": "${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

   • The command keeps the value in ~/.claude.json; the .mcp.json version refers to an environment variable, so nothing secret is committed.

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

   Servers are read when Claude Code starts, so this step is for the case where the new entry is missing. It also covers the approval prompt for project files.

   • The docs do not say a restart is needed after claude mcp add. Servers connect at startup and can be reconnected from the /mcp menu.
   • In an interactive session Claude Code asks you to approve servers from a project .mcp.json before it uses them; claude mcp reset-project-choices resets those answers.

claude mcp list