skills.rest
eklyukin
eklyukinCOMMUNITY
Explore all skills by this author →
GitHub

neo4j-mcp-skill

Installs and configures the official Neo4j MCP server for MCP-compatible editors.

Updated Jul 24, 2026
Search Tags:#claude code#configuration#mcp server#graph database#neo4j#editor integration#cypher
One-click install
npx skills add https://github.com/eklyukin/my-ai-config --skill neo4j-mcp-skill-eklyukin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neo4j-mcp-skill
Source: https://github.com/eklyukin/my-ai-config/tree/main/skills/neo4j-mcp-skill
Command: npx skills add https://github.com/eklyukin/my-ai-config --skill neo4j-mcp-skill-eklyukin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires neo4j-mcp-server.

What problem does it solve? Connecting AI coding assistants to a Neo4j graph database requires correct MCP server installation, editor-specific JSON configuration, credential handling, and transport setup, which is error-prone and differs across editors. ## Core Features & Use Cases - Editor Configuration: Provides ready-to-merge MCP config blocks for Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Kiro, Cline, and Antigravity, including the VS Code servers vs mcpServers difference. - Transport & Access Control: Covers stdio and HTTP transport modes, per-request Basic auth, and read-only mode via NEO4J_READ_ONLY to hide the write-cypher tool. - Troubleshooting & Verification: Includes a connectivity smoke test (RETURN 'connected'), an APOC requirement check for get-schema, and a symptom-to-fix table for common failures. - Use Case: You want Claude Code to query your Aura instance. Follow the steps to install neo4j-mcp-server, capture its absolute path, merge the config into ~/.claude/settings.json, restart, and verify with a smoke test. ## Quick Start Ask your AI assistant to install the Neo4j MCP server and configure your editor to connect to your Neo4j database in read-only mode.

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 Claude Code to a Neo4j database via MCP?▼

Install neo4j-mcp-server with pip, get its absolute path with `which neo4j-mcp`, then add a `neo4j` entry under `mcpServers` in `~/.claude/settings.json` with NEO4J_URI, username, password, and database env vars. Restart Claude Code and verify with `read-cypher: RETURN 'connected' AS status`.

What tools does the Neo4j MCP server provide?▼

The server exposes four tools: get-schema for labels, relationship types, and indexes; read-cypher for read-only queries; write-cypher for MERGE, CREATE, SET, and DELETE; and list-gds-procedures for Graph Data Science procedures. Setting NEO4J_READ_ONLY=true hides write-cypher.

Does the Neo4j MCP server work with VS Code and Cursor?▼

Yes, both are supported. VS Code uses `.vscode/mcp.json` with a `servers` key and `"type": "stdio"`, while Cursor uses `~/.cursor/mcp.json` or `.cursor/mcp.json` with the `mcpServers` structure shared by Claude Code, Windsurf, and Kiro.

Why is the Neo4j MCP server not showing up in my editor?▼

The most common causes are a wrong config file path, malformed JSON, or the editor not being restarted. Validate the JSON with `python3 -m json.tool`, confirm you edited the correct file for your editor, and always use the absolute path to the neo4j-mcp binary in the `command` field.

Why is the write-cypher tool missing from the Neo4j MCP server?▼

The write-cypher tool is hidden when NEO4J_READ_ONLY is set to true in the server environment. Remove the variable or set it to false if your workflow requires writes such as imports, MERGE operations, or schema changes.

When should I not use the Neo4j MCP server skill?▼

Use other skills for adjacent tasks: neo4j-cypher for writing or optimizing queries, neo4j-aura-provisioning-skill for creating Aura instances, neo4j-agent-memory-skill for agent long-term memory, and neo4j-cli-tools-skill for neo4j-admin, cypher-shell, or aura-cli operations.

Related Skills

Explore More Software Engineering Skills→
neo4j-contribneo4j-contrib
101

neo4j-aura-provisioning-skill

Automate Neo4j Aura instance lifecycle operations via aura-cli and REST API.

Official
Advanced
gganbukim1gganbukim1

codebase-memory-reference

Reference MCP tools and Cypher queries for codebase knowledge graph exploration.

Community
Basic
neo4j-contribneo4j-contrib
101

neo4j-cli-tools-skill

Automate Neo4j administration tasks across neo4j-admin, cypher-shell, and aura-cli.

Official
Intermediate
MSiccDevMSiccDev
20

arc42-section-10

Generate measurable quality scenarios for arc42 Section 10 from Section 1.2 goals.

Official
Intermediate