Neo4j MCP

Neo4j MCP gives AI assistants and LLM-powered tools direct, structured access to your Neo4j graph database. By implementing the Model Context Protocol (MCP), it acts as a bridge between any MCP-compatible client, such as Claude, Cursor, or VS Code with MCP support, and your Neo4j instance.

Features

• Explore your graph schema - discover node labels, relationship types, and property keys
• Let AI reason on your data model without prior knowledge
• Run Cypher queries - execute, read, and write queries against your database in response to natural language prompts
• Inspect and analyze data - retrieve nodes, relationships, and paths to answer questions, generate summaries, or feed data to other workflows

Tools

• get-schema — introspect labels, relationship types, property keys
• read-cypher — execute read-only Cypher queries that do not modify database data, enforced via EXPLAIN and Neo4j's query-type classification. Note: custom procedures or functions incorrectly classified as read-only by Neo4j may bypass this check; ensuring correct classification is the responsibility of the procedure/function maintainer.
• write-cypher — execute write Cypher queries (disabled if NEO4J_MCP_READ_ONLY=true)
• list-gds-procedures — list available GDS procedures

Installation

Install with PyPI:

pip install neo4j-mcp-server

Otherwise see MCP documentation -> Installation.

Server configuration (VSCode)

Create / edit mcp.json:

{
  "servers": {
    "neo4j": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "neo4j_mcp_server"],
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

See MCP documentation > Configuration for more details.

Links

• Documentation: The official Neo4j MCP documentation.
• Discord: The Neo4j discord channel.
• Contributing Guide: Contribution workflow, development environment, mocks and testing.

For issues and feedback, you can also create a GitHub issue with reproduction details (omit sensitive data).