neo4j-mcp-skill

Configures the official Neo4j MCP server for schema exploration and Cypher execution.

101|35|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/neo4j-contrib/neo4j-skills --skill neo4j-mcp-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neo4j-mcp-skill
Source: https://github.com/neo4j-contrib/neo4j-skills/tree/main/neo4j-mcp-skill
Command: npx skills add https://github.com/neo4j-contrib/neo4j-skills --skill neo4j-mcp-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Connecting Neo4j to MCP-capable editors often fails due to misconfigured transport, missing environment variables, or incorrect tool expectations, preventing reliable schema discovery and Cypher execution.

Core Features & Use Cases

  • MCP Server Installation & Configuration: Installs and configures the official Neo4j MCP server and guides you through editor-specific setup for stdio-based integrations (and optional HTTP transport).
  • Tooling for Schema and Query Execution: Enables the MCP toolset to (a) fetch schema, (b) run read-only Cypher, (c) run write Cypher when allowed, and (d) list Graph Data Science procedures.
  • Write Safety Controls & Multi-DB Support: Uses NEO4J_READ_ONLY to control whether write-cypher is available and supports explicit NEO4J_DATABASE targeting.

Quick Start

Tell the AI: "Install neo4j-mcp-server and configure my Claude Code MCP server to connect to my Neo4j Aura database in read-only mode using stdio transport."

Frequently Asked Questions about neo4j-mcp-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect my Claude Desktop or Cursor editor to a Neo4j database?

To connect a Neo4j database to Claude Desktop or Cursor, you configure the official Neo4j MCP server using stdio or HTTP transport, enabling schema exploration and Cypher execution directly within the editor.

What is the difference between stdio and HTTP transport for Neo4j MCP servers?

Stdio transport is the standard method for local editor integrations like Claude Code and VS Code, while HTTP transport provides an alternative connection method for MCP-compatible clients communicating with the Neo4j server.

Can I restrict my MCP editor to run read-only Cypher queries against Neo4j?

Yes, you can restrict MCP editors to read-only Cypher by setting the NEO4J_READ_ONLY environment variable, which gates the write-cypher tool and prevents unauthorized database modifications during schema exploration.

How do I use MCP tools to fetch Neo4j schema and list Graph Data Science procedures?

The Neo4j MCP server exposes the get-schema tool for fetching database structure and the list-gds-procedures tool for listing Graph Data Science procedures, relying on APOC for schema introspection.

Does the Neo4j MCP server support connecting to multiple databases?

Yes, the Neo4j MCP server supports multi-database configuration by using the explicit NEO4J_DATABASE environment variable to target specific databases for your schema exploration and Cypher execution.

Why does my MCP editor fail to execute Cypher queries against Neo4j?

MCP editor Cypher execution fails when transport is misconfigured, required environment variables are missing, or tool expectations are incorrect, preventing reliable schema discovery and query execution against the Neo4j database.