---
title: "Neo4j Graph MCP Server Setup Guide and Schema"
slug: "neo4j"
category: "databases"
package: "mcp-neo4j"
transport: "stdio"
canonical: "https://mcp-codex.com/servers/neo4j"
source: "MCP Codex (https://mcp-codex.com)"
dateModified: "2026-09-28"
---

# Neo4j Graph MCP Server

> Query graph databases with Cypher, explore nodes, relationships, and schemas.

## Overview
Connect AI agents to Neo4j graph databases. Run Cypher queries, explore node relationships, inspect graph schemas, and leverage graph-native data structures for knowledge graphs, social networks, and recommendation engines.

## Quick Install
```bash
uvx mcp-neo4j
```

## Environment Variables

| Variable | Description | Required |
| :--- | :--- | :--- |
| `NEO4J_URI` | Neo4j Bolt URI | **Yes** |
| `NEO4J_USERNAME` | Neo4j username | **Yes** |
| `NEO4J_PASSWORD` | Neo4j password | **Yes** |

## Client Configurations

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "neo4j": {
      "command": "uvx",
      "args": [
        "mcp-neo4j"
      ],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": ""
      }
    }
  }
}
```

### Cursor (`mcp.json`)
```json
{
  "mcpServers": {
    "neo4j": {
      "command": "uvx",
      "args": [
        "mcp-neo4j"
      ],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": ""
      }
    }
  }
}
```

### OpenAI Codex CLI (`~/.codex/config.toml`)
```toml
[mcp_servers.neo4j]
command = "uvx"
args = ["mcp-neo4j"]

[mcp_servers.neo4j.env]
NEO4J_URI = "bolt://localhost:7687"
NEO4J_USERNAME = "neo4j"
NEO4J_PASSWORD = ""
```

## Available Tools (3)

- `read_cypher_query`
- `write_cypher_query`
- `get_schema`

## Documentation & Links
- Canonical Web Page: https://mcp-codex.com/servers/neo4j
- Weekly Protocol Changelog: https://mcp-codex.com#newsletter
- GitHub Repository: https://github.com/neo4j-contrib/mcp-neo4j
- Setup Tutorial Guide: https://mcp-codex.com/articles/neo4j-graph-mcp