How to install mcp-neo4j in Windsurf

MCP server for Neo4j Aura Database Instance Manager.

Indexed, not yet reviewed

We found mcp-neo4j in the official MCP registry. Our automated check passed on Nov 1, 2026 (it confirms the server is published and reachable), but no one at CuratedMCP has reviewed its code, permissions or credentials handling. Check what it can access before you give it keys. Scan your machine free to see every MCP server you have installed.

Steps

1Install uv (for uvx): https://docs.astral.sh/uv/
2Open ~/.codeium/windsurf/mcp_config.json
3Add the entry below. If the file already has "mcpServers", add just the inner entry
4Refresh the MCP servers list in Windsurf's Cascade panel

Configuration

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "neo4j": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-aura-manager"
      ],
      "env": {
        "NEO4J_AURA_CLIENT_ID": "<your-neo4j-aura-client-id>",
        "NEO4J_AURA_CLIENT_SECRET": "<your-neo4j-aura-client-secret>"
      }
    }
  }
}

Replace the values in angle brackets. Optional settings are listed below.

Environment variable	Required	What it is
NEO4J_AURA_CLIENT_IDsecret	Yes	Neo4j Aura API Client ID
NEO4J_AURA_CLIENT_SECRETsecret	Yes	Neo4j Aura API Client Secret
NEO4J_NAMESPACE	No	Namespace for tools

Install in other clients

Claude Code Cursor Claude Desktop Gemini CLI OpenAI Agents SDK

About mcp-neo4j: repo, license and check results →

Maintain mcp-neo4j?

Claim this page to get a full CuratedMCP listing: edit your description, see listing analytics, and add our README badge. Listing is free, and a person checks every submission before it goes live. We'll pre-fill the form from the registry.

Claim this listing What maintainers get