MCP Neo4j Server

What is MCP Neo4j Server?

An MCP server that integrates Neo4j graph database with Claude Desktop, enabling graph database operations through natural language interactions.

How to use MCP Neo4j Server?

Run directly via npx @alanse/mcp-neo4j or add it to Claude Desktop configuration with environment variables NEO4J_URI, NEO4J_USERNAME, and NEO4J_PASSWORD. The server provides three tools: execute_query, create_node, and create_relationship.

Key features of MCP Neo4j Server

• Execute any Cypher query against the Neo4j database.
• Create nodes with specified labels and properties.
• Create relationships between existing nodes with types.
• Supports all Cypher query types (READ, CREATE, UPDATE, DELETE).
• Parameters available to prevent injection attacks.

Use cases of MCP Neo4j Server

• Query graph data using natural language, e.g., "Show me all employees in Sales".
• Create new nodes like people, products, or departments via conversation.
• Establish relationships between nodes, e.g., "Make John Doe friends with Jane Smith".
• Perform complex graph traversals like friends-of-friends or aggregate queries.

FAQ from MCP Neo4j Server

What dependencies or runtime are required?

The server runs via npx (Node.js) and requires a running Neo4j database instance accessible at the configured URI.

How do I configure the server for my Neo4j database?

Set the environment variables NEO4J_URI (default bolt://localhost:7687), NEO4J_USERNAME (default neo4j), and NEO4J_PASSWORD (required).

What transport or authentication does the server use?

The server connects to Neo4j using the Bolt protocol and requires database credentials (username and password) for authentication.

Can I install the server without using npm?

Yes, you can install it automatically via Smithery with the command npx @smithery/cli install @alanse/mcp-neo4j-server --client claude.

How do I run the server for development?

Clone the repository, run npm install and npm run build, then configure Claude Desktop to use the local build.