da-okazaki/mcp-neo4j-server

An MCP server that provides integration between Neo4j graph database and Claude Desktop, enabling graph database operations through natural language interactions.
Quick Start
You can run this MCP server directly using npx:
Or add it to your Claude Desktop configuration:
Features
This server provides tools for interacting with a Neo4j database:
Neo4j Enterprise Support
This server now supports connecting to specific databases in Neo4j Enterprise Edition. By default, it connects to the "neo4j" database, but you can specify a different database using the NEO4J_DATABASE environment variable.
Tools
- execute_query: Execute Cypher queries on the Neo4j database
- Supports all types of Cypher queries (READ, CREATE, UPDATE, DELETE)
- Returns query results in a structured format
- Parameters can be passed to prevent injection attacks
- create_node: Create a new node in the graph database
- Specify node labels and properties
- Returns the created node with its internal ID
- Supports all Neo4j data types for properties
- create_relationship: Create a relationship between two existing nodes
- Define relationship type and direction
- Add properties to relationships
- Requires node IDs for source and target nodes
Installation
Installing via Smithery
To install MCP Neo4j Server for Claude Desktop automatically via Smithery:
For Development
1. Clone the repository:
2. Install dependencies:
3. Build the project:
Configuration
The server requires the following environment variables:
- NEO4J_URI: Neo4j database URI (default: bolt://localhost:7687)
- NEO4J_USERNAME: Neo4j username (default: neo4j)
- NEO4J_PASSWORD: Neo4j password (required)
- NEO4J_DATABASE: Neo4j database name (default: neo4j) - Use this to connect to a specific database in Neo4j Enterprise
Usage Examples
Here are examples of how you can interact with the Neo4j database using natural language:
Connecting to a Specific Database
For Neo4j Enterprise users with multiple databases, you can specify which database to connect to:
This will connect to "myCustomDatabase" instead of the default "neo4j" database.
Querying Data
You can ask questions like:
- "Show me all employees in the Sales department"
- "Find the top 5 oldest customers"
- "Who has purchased more than 3 products in the last month?"
Example:
Creating Data
You can give instructions like:
- "Add a new person named John Doe who is 30 years old"
- "Create a product called 'Premium Coffee' with price $24.99"