Skip to content
appsgit

MCP Neo4j Cypher

MCP Neo4j Cypher is an MCP server that allows you to run Cypher queries against a Neo4j database. It has 988 GitHub stars, is released under the MIT license and runs locally with uvx mcp-neo4j-cypher. It works with Claude Desktop, Claude Code, Cursor and VS Code and needs an API key.

github.com/neo4j-contrib/mcp-neo4j (opens in a new tab)

  • Official
  • Needs API key
  • Databases
  • MIT
  • Actively maintained

Install MCP Neo4j Cypher

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "mcp-neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "your-value",
        "NEO4J_USERNAME": "your-value",
        "NEO4J_PASSWORD": "your-value",
        "NEO4J_RESPONSE_TOKEN_LIMIT": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env NEO4J_URI=your-value --env NEO4J_USERNAME=your-value --env NEO4J_PASSWORD=your-value --env NEO4J_RESPONSE_TOKEN_LIMIT=your-value --transport stdio mcp-neo4j-cypher -- uvx mcp-neo4j-cypher

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "mcp-neo4j-cypher": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "your-value",
        "NEO4J_USERNAME": "your-value",
        "NEO4J_PASSWORD": "your-value",
        "NEO4J_RESPONSE_TOKEN_LIMIT": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "neo4j_password",
      "description": "NEO4J_PASSWORD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "neo4j_response_token_limit",
      "description": "NEO4J_RESPONSE_TOKEN_LIMIT",
      "password": true
    }
  ],
  "servers": {
    "mcp-neo4j-cypher": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "your-value",
        "NEO4J_USERNAME": "your-value",
        "NEO4J_PASSWORD": "${input:neo4j_password}",
        "NEO4J_RESPONSE_TOKEN_LIMIT": "${input:neo4j_response_token_limit}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
NEO4J_URIYesNeo4j connection URI
NEO4J_USERNAMEYesNeo4j username
NEO4J_PASSWORDsecretYesNeo4j password
NEO4J_DATABASENoNeo4j database name
NEO4J_NAMESPACENoTool namespace prefix
NEO4J_RESPONSE_TOKEN_LIMITsecretNoMaximum tokens for read query responses
NEO4J_READ_TIMEOUTNoTimeout in seconds for read queries
NEO4J_READ_ONLYNoAllow only read-only queries (true/false)
NEO4J_SCHEMA_SAMPLE_SIZENoSchema sample size

Tools (6)

Parsed from the Tools section of the README; check the repository for the current list.

  • read_neo4j_cypher
  • query

    The Cypher query to execute

  • params

    Parameters to pass to the Cypher query

  • write_neo4j_cypher
  • get_neo4j_schema
  • sample_param

    Number of nodes to sample for schema analysis. Overrides server default if provided.

About MCP Neo4j Cypher

mcp-name: io.github.neo4j-contrib/mcp-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.

  • database
  • mcp
  • mcp-server
  • neo4j
  • stdio

FAQ

MCP Neo4j Cypher FAQ

Still curious? Email info@appsgit.com.

What is MCP Neo4j Cypher?

MCP Neo4j Cypher is an MCP server that allows you to run Cypher queries against a Neo4j database. It has 988 GitHub stars, is released under the MIT license and runs locally with uvx mcp-neo4j-cypher. It works with Claude Desktop, Claude Code, Cursor and VS Code and needs an API key. The source code is at github.com/neo4j-contrib/mcp-neo4j.

How do I install the MCP Neo4j Cypher MCP server?

Add the command uvx mcp-neo4j-cypher to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is MCP Neo4j Cypher free?

The server is open source under the MIT license, so running it is free. It needs credentials (NEO4J_PASSWORD and NEO4J_RESPONSE_TOKEN_LIMIT) for the service it connects to, which may require a paid account.

Is MCP Neo4j Cypher actively maintained?

The most recent commit was on Sep 9, 2026. The latest release is mcp-neo4j-cypher-v0.6.0, published Apr 10, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.