PlugWiki
Neo4j Data Modeling MCP logo

Neo4j Data Modeling MCP Server: Design Graph Models in Claude, Cursor and Other Apps

OfficialLocal

Lets Claude, Cursor and other assistants design, check and draw Neo4j graph data models, and write the Cypher to load them.

You describe your data, and the assistant builds a graph model of nodes and relationships, checks it, and shows it as a diagram. It can import and export models from Arrows, OWL and the Neo4j GraphRAG package, and write the Cypher that loads your data. The server runs on your computer and does not connect to a database. To load data for real, pair it with the Neo4j Cypher server.

Good for

  • Data engineers planning a graph model before they load data
  • Teams moving from an ontology or Arrows sketch to a working Neo4j schema
  • Developers who want Cypher load scripts generated from a model

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install Neo4j Data Modeling MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Neo4j Data Modeling MCP server to Claude Code. Run this command:
    
    claude mcp add neo4j-data-modeling -- uvx mcp-neo4j-data-modeling
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires uv (Python).

Built from the package data we hold. Not yet tested by us.

Tools

  • Checks one node definition

    Checks that a single node definition has the right shape and raises an error that says what is wrong. It can return the cleaned node.

    Try: “Check that my Customer node definition is valid.”

    validate_node

  • Checks one relationship definition

    Checks that a relationship definition is well formed, including its type and its start and end nodes.

    Try: “Is this PURCHASED relationship between Customer and Product valid?”

    validate_relationship

  • Checks a whole data model

    Checks every node and relationship in a model together and reports problems, such as links to nodes that do not exist.

    Try: “Validate the whole data model before we go on.”

    validate_data_model

  • Draws the model as a diagram

    Returns Mermaid diagram text for a data model, which Claude Desktop and other apps with Mermaid support can show as a picture.

    Try: “Show my data model as a diagram.”

    get_mermaid_config_str

  • Imports a model drawn in Arrows

    Converts JSON exported from the Arrows graph drawing app into a data model.

    Try: “Load this Arrows export as a data model.”

    load_from_arrows_json

  • Exports a model for Arrows

    Converts a data model to the JSON format that the Arrows app opens, so you can edit it visually.

    Try: “Export this model so I can open it in Arrows.”

    export_to_arrows_json

  • Imports an OWL ontology

    Turns an OWL Turtle ontology into a data model. Classes become nodes, object properties become relationships and data properties become node properties. The conversion loses some detail.

    Try: “Convert this OWL ontology into a Neo4j data model.”

    load_from_owl_turtle

  • Exports a model as an OWL ontology

    Writes a data model as OWL Turtle text. Properties on relationships are not kept, because OWL has no place for them.

    Try: “Export the model as an OWL ontology.”

    export_to_owl_turtle

  • Exports a model as Python classes

    Returns Python code with Pydantic classes for each node, each relationship and the whole model.

    Try: “Generate Pydantic models for my graph schema.”

    export_to_pydantic_models

  • Exports a model for the GraphRAG package

    Converts a data model to the schema dictionary used by the Neo4j GraphRAG Python package.

    Try: “Give me this model as a GraphRAG schema.”

    export_to_neo4j_graphrag_pkg_schema

  • Imports a GraphRAG package schema

    Builds a data model from a schema dictionary used by the Neo4j GraphRAG Python package.

    Try: “Load my GraphRAG schema as a data model.”

    load_from_neo4j_graphrag_pkg_schema

  • Lists the built-in example models

    Lists seven example models, such as patient journey and supply chain, with a description and the node and relationship counts of each.

    Try: “What example data models do you have?”

    Read · list_example_data_models

Read from the source code

Permissions

low risk · 3 things to watch

Low risk

All 16 tools work on the model text you give them and return text, so nothing on your computer or in a database changes. Nothing is sent anywhere except through your AI assistant.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It does not run the Cypher it writes

    The ingest and constraint tools only return query text. Review it before you run it with another server or in the Neo4j browser. github.com

  • OWL conversion loses detail

    Converting to and from OWL is lossy, and relationship properties are not kept in OWL. Check the result before you rely on it. github.com

  • HTTP mode defaults to localhost

    If you choose http or sse, the server binds 127.0.0.1 unless you set another host. The Docker image sets 0.0.0.0, so publish its port with care. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Sign-in and keysNo sign-in, API key or database connection is needed.

Questions

Is the Neo4j Data Modeling MCP server official?

It is a Neo4j Labs server, made by Neo4j but not supported by Neo4j's product team. The repo README says the Labs servers are updated often with experimental features. Neo4j's supported product server is a different project: see Neo4j MCP (github.com/neo4j/mcp).

Should I use this or the Neo4j product server?

Use the Neo4j MCP server if you want the one Neo4j's product team supports. Use this Labs Data Modeling server if you need what it does that the product server may not, and accept that it can change quickly and has no product support.

Do I need a Neo4j database?

No. This server never connects to a database. It only designs models and writes query text. Use the Neo4j Cypher server to run the queries.

Does it need an API key or sign-in?

No. There are no credentials to set.

Can it change my files or data?

No. Every tool returns text. The tools that write Cypher do not run it.

What can I import and export?

It reads and writes Arrows JSON, OWL Turtle and the Neo4j GraphRAG package schema, and exports Python Pydantic classes and Mermaid diagrams.

What are the built-in examples?

Seven models: patient journey, supply chain, software dependency, oil and gas monitoring, customer 360, fraud and AML, and health insurance fraud.

How is it different from the Neo4j Cypher server?

This one designs models and does not touch a database. The Cypher server runs queries on a live database, including writes.

Is it free?

Yes. The repo is MIT licensed, but the published 0.8.2 wheel on PyPI has no license file and no license field in its metadata. No database is needed.

Information

updated Nov 2, 2026

Publisher
Official
Package
mcp-neo4j-data-modeling
Registry
PyPI
Transport
stdio
Auth
None
Version
1.0.0
License
MIT
Last commit
Sep 9, 2026
Open issues
17
Listed in
Official MCP registry, Docker MCP Catalog

GitHubPyPIOfficial MCP Registry

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 4
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. pypi.org · pypi.org

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.