Neo4j Cypher MCP Server

A Model Context Protocol (MCP) server implementation that provides database interaction and allows graph exploration capabilities through Neo4j. This server enables running Cypher graph queries, analyzing complex domain data, and automatically generating business insights that can be enhanced further with an application's analysis tools.

People connecting database tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-04-10 · ★ 979 · #184 OF 848 MAINTAINED DATABASE · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Neo4j Cypher

before you install - you'll need

Set NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD, NEO4J_DATABASE, NEO4J_NAMESPACE, NEO4J_READ_TIMEOUT, NEO4J_RESPONSE_TOKEN_LIMIT, NEO4J_SCHEMA_SAMPLE_SIZE, NEO4J_MCP_SERVER_ALLOWED_HOSTS, NEO4J_TRANSPORT, NEO4J_MCP_SERVER_HOST before connecting. NEO4J_MCP_SERVER_ALLOW_ORIGINS is optional or environment-specific per the README.

Claude Code

claude mcp add neo4j-contrib-mcp-neo4j-servers-mcp-neo4 -- uvx mcp-neo4j-cypher

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "neo4j-contrib-mcp-neo4j-servers-mcp-neo4": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package mcp-neo4j-cypher - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.neo4j-contrib is GitHub-verified and matches the repo owner

03 · What Neo4j Cypher can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

mcp-neo4j-cypher-v0.6.0 · 2026-04-10

v0.6.0 · Fixed · Fix startup ImportError caused by pydocket importing FakeConnection from fakeredis>=2.27 - cap fastmcp<2.14 to exclude the pydocket transitive dependency · Fix TypeError: str expected, not int in…

mcp-gemini-ext-v1.0.1 · 2026-03-18

use extension settings for Gemini CLI extension · New Contributors · @jackwotherspoon made their first contribution in

mcp-neo4j-memory-v0.4.5 · 2026-02-23

Changed · Security upgrade python from 3.11-slim to 3.13.8-slim · Change default MCP server endpoint from /api/mcp/ to /mcp/ · Lock FastMCP version to <3.x · New Contributors · @bryankthompson made their first…

04 · Who maintains Neo4j Cypher

mcp-neo4j-cypher is maintained by neo4j-contrib. We track 5 MCP servers from neo4j-contrib - 5 actively maintained, 1,075 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from neo4j-contrib.

  1. mcp-neo4j-memory MCP Neo4j Knowledge Graph Memory Server ★ 979
  2. mcp-neo4j-data-modeling A simple Neo4j MCP server for creating graph data models. ★ 979
  3. mcp-neo4j-aura-manager MCP server for Neo4j Aura Database Instance Manager. ★ 979
  4. Neo4j GDS Agent Neo4j Graph Data Science MCP server ★ 96

05 · Facts

category
database - ranked #184 of 848 actively-maintained database servers as of 2026-08-25.
registry
io.github.neo4j-contrib/mcp-neo4j-cypher (active, first published 2025-11-07 · 4 versions)
packages
pypi:mcp-neo4j-cypher

06 · Neo4j Cypher FAQ

What is Neo4j Cypher?

A Model Context Protocol (MCP) server implementation that provides database interaction and allows graph exploration capabilities through Neo4j. This server enables running Cypher graph queries, analyzing complex domain data, and automatically generating business insights that can be enhanced further with an application's analysis tools.

Is Neo4j Cypher still maintained?

Yes - as of 2026-08-25, its last commit was 2026-04-10. We re-verify nightly.

How do I install Neo4j Cypher?

Run `uvx mcp-neo4j-cypher`. The README documents 12 environment variables (NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD…) to set first. Set NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD, NEO4J_DATABASE, NEO4J_NAMESPACE, NEO4J_READ_TIMEOUT, NEO4J_RESPONSE_TOKEN_LIMIT, NEO4J_SCHEMA_SAMPLE_SIZE, NEO4J_MCP_SERVER_ALLOWED_HOSTS, NEO4J_TRANSPORT, NEO4J_MCP_SERVER_HOST before connecting. NEO4J_MCP_SERVER_ALLOW_ORIGINS is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Neo4j Cypher run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Neo4j Cypher