Course
Give your AI a permanent memory of your business. A course for people who use ChatGPT or Claude daily.Compound Context
neo4j-contrib

mcp-neo4j

by neo4j-contrib

931stars241forks
View on GitHubWebsite
localPythonMIT
AboutToolsREADME

About mcp-neo4j

This collection of tools connects your AI chat apps directly to Neo4j graph databases. It lets your assistant view data structures, run safe queries to find or save information, and manage your cloud database settings using simple text prompts.

Compound Context

Give your AI a memory

Build one knowledge base all your AI tools draw from, kept current with your review.

Course

Tools (57)

get-neo4j-schema

Extract the graph database schema.

read-neo4j-cypher

Execute read Cypher statements on the database.

write-neo4j-cypher

Execute write Cypher statements on the database.

read_graph

Load whole graph.

search_nodes

Search nodes by search string.

find_nodes

Find nodes by name.

create_entities

Create memory entities.

delete_entities

Delete memory entities.

create_relations

Manage/create relationships.

delete_relations

Delete relationships.

add_observations

Add observation statements to entities.

delete_observations

Delete observation statements.

list_instances

List instances.

get_instance_details

Get instance details.

get_instance_by_name

Get instance by name.

create_instance

Create an instance.

delete_instance

Delete an instance.

update_instance_name

Update instance name.

update_instance_memory

Update instance memory.

update_instance_vector_optimization

Update instance vector optimization.

pause_instance

Pause an instance.

resume_instance

Resume an instance.

list_tenants

List tenants.

get_tenant_details

Get tenant details.

validate_node

Validate a single node.

validate_relationship

Validate a single relationship.

validate_data_model

Validate a whole data model.

get_mermaid_config_str

Generate a configuration for Mermaid diagram visualization.

load_from_arrows_json

Import a data model created in the Arrows web application.

export_to_arrows_json

Export a data model to Arrows format.

get_constraints_cypher_queries

Get the Cypher to create all necessary constraints.

get_node_cypher_ingest_query

Get the Cypher query to ingest the provided node label.

get_relationship_cypher_ingest_query

Get the Cypher query to ingest the provided relationship type.

list_example_data_models

List all available example data models with descriptions.

get_example_data_model

Get an example graph data model from the available templates.

patient_journey_model

Data Model for tracking patient encounters, conditions, medications, and care plans.

supply_chain_model

Data Model for tracking products, orders, inventory, and locations.

software_dependency_model

Data Model for software dependency tracking with security vulnerabilities, commits, and contributor analysis.

oil_gas_monitoring_model

Data Model for industrial monitoring of oil and gas equipment, sensors, alerts, and maintenance.

customer_360_model

Data Model for customer relationship management with accounts, contacts, orders, tickets, and surveys.

fraud_aml_model

Data Model for financial fraud detection and anti-money laundering with customers, transactions, alerts, and compliance.

health_insurance_fraud_model

Data Model for healthcare fraud detection tracking investigations, prescriptions, executions, and beneficiary relationships.

create_new_data_model

Provide a structured parameterized prompt for generating a new graph data model.

start_new_sandbox

Creates a new sandbox instance for a specific use case.

list_sandboxes_for_user

Lists all active sandboxes for the user.

terminate_sandbox

Deletes a sandbox instance.

get_sandbox_connection_details

Retrieves connection details for a sandbox.

extend_sandbox_lifetime

Extends the lifetime of a sandbox.

get_schema

Fetches the graph schema from a sandbox.

read_query

Executes a read-only Cypher query.

write_query

Executes a write Cypher query.

request_sandbox_backup

Requests a backup for a sandbox.

list_sandbox_backups

Lists available backups for a sandbox.

get_backup_result

Retrieves the result of a backup task.

get_sandbox_backup_download_url

Gets a download URL for a backup file.

upload_sandbox_to_aura

Uploads a sandbox backup to an Aura instance.

get_aura_upload_result

Retrieves the result of an Aura upload task.

README

Neo4j Labs MCP Servers

Neo4j Labs

These MCP servers are a part of the Neo4j Labs program. They are developed and maintained by the Neo4j Field GenAI team and welcome contributions from the larger developer community. These servers are frequently updated with new and experimental features, but are not supported by the Neo4j product team.

They are actively developed and maintained, but we don’t provide any SLAs or guarantees around backwards compatibility and deprecation.

If you are looking for the official product Neo4j MCP server please find it here.

Overview

Model Context Protocol (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems.

This lets you use Claude Desktop, or any other MCP Client (VS Code, Cursor, Windsurf, Gemini CLI), to use natural language to accomplish things with Neo4j and your Aura account, e.g.:

  • What is in this graph?
  • Render a chart from the top products sold by frequency, total and average volume
  • List my instances
  • Create a new instance named mcp-test for Aura Professional with 4GB and Graph Data Science enabled
  • Store the fact that I worked on the Neo4j MCP Servers today with Andreas and Oskar

Servers

mcp-neo4j-cypher - natural language to Cypher queries

Details in Readme

Get database schema for a configured database and execute generated read and write Cypher queries on that database.

Requirement: Requires the APOC plugin to be installed and enabled on the Neo4j instance for schema inspection.

mcp-neo4j-memory - knowledge graph memory stored in Neo4j

Details in Readme

Store and retrieve entities and relationships from your personal knowledge graph in a local or remote Neo4j instance. Access that information over different sessions, conversations, clients.

mcp-neo4j-cloud-aura-api - Neo4j Aura cloud service management API

Details in Readme

Manage your Neo4j Aura instances directly from the comfort of your AI assistant chat.

Create and destroy instances, find instances by name, scale them up and down and enable features.

mcp-neo4j-data-modeling - interactive graph data modeling and visualization

Details in Readme

Create, validate, and visualize Neo4j graph data models. Allows for model import/export from Arrows.app.

Transport Modes

All servers support multiple transport modes:

  • STDIO (default): Standard input/output for local tools and Claude Desktop integration
  • SSE: Server-Sent Events for web-based deployments
  • HTTP: Streamable HTTP for modern web deployments and microservices

HTTP Transport Configuration

To run a server in HTTP mode, use the --transport http flag:

# Basic HTTP mode
mcp-neo4j-cypher --transport http

# Custom HTTP configuration
mcp-neo4j-cypher --transport http --host 127.0.0.1 --port 8080 --path /api/mcp/

Environment variables are also supported:

export NEO4J_TRANSPORT=http
export NEO4J_MCP_SERVER_HOST=127.0.0.1
export NEO4J_MCP_SERVER_PORT=8080
export NEO4J_MCP_SERVER_PATH=/api/mcp/
mcp-neo4j-cypher

Cloud Deployment

All servers in this repository are containerized and ready for cloud deployment on platforms like AWS ECS Fargate and Azure Container Apps. Each server supports HTTP transport mode specifically designed for scalable, production-ready deployments with auto-scaling and load balancing capabilities.

📋 Complete Cloud Deployment Guide →

The deployment guide covers:

  • AWS ECS Fargate: Step-by-step deployment with auto-scaling and Application Load Balancer
  • Azure Container Apps: Serverless container deployment with built-in scaling and traffic management
  • Configuration Best Practices: Security, monitoring, resource recommendations, and troubleshooting
  • Integration Examples: Connecting MCP clients to cloud-deployed servers

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Blog Posts

License

MIT License

Category

Customer Data Platforms

Technical Details

Scope
local
Language
Python
License
MIT
Operating Systems
linuxmacoswindows

Links

GitHub RepositoryHomepageMain URL