# MCP Neo4j Cypher (MCP server)

> 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.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/neo4j-contrib/mcp-neo4j |
| GitHub stars | 988 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: mcp-neo4j-cypher |
| Remote URL | none |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Databases |
| Latest release | mcp-neo4j-cypher-v0.6.0 (Apr 10, 2026) |
| Last commit | Sep 9, 2026 |
| MCP registry name | io.github.neo4j-contrib/mcp-neo4j-cypher |

## Install

### Claude Desktop (claude_desktop_config.json)

```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

```sh
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)

```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)

```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 2026-10-07.

## Environment variables

- `NEO4J_URI` (required): Neo4j connection URI
- `NEO4J_USERNAME` (required): Neo4j username
- `NEO4J_PASSWORD` (secret) (required): Neo4j password
- `NEO4J_DATABASE`: Neo4j database name
- `NEO4J_NAMESPACE`: Tool namespace prefix
- `NEO4J_RESPONSE_TOKEN_LIMIT` (secret): Maximum tokens for read query responses
- `NEO4J_READ_TIMEOUT`: Timeout in seconds for read queries
- `NEO4J_READ_ONLY`: Allow only read-only queries (true/false)
- `NEO4J_SCHEMA_SAMPLE_SIZE`: Schema sample size

## Tools

- `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.

## Similar MCP servers

- [Dbx](https://appsgit.com/mcp-servers/dbx): Query databases from AI agents using connections configured in DBX. (24,945 stars, Apache-2.0)
- [Butterbase AI MCP Server](https://appsgit.com/mcp-servers/butterbase-ai-mcp-server): Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys. (3,686 stars, Apache-2.0, needs API key)
- [DBHub](https://appsgit.com/mcp-servers/dbhub): Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite. (3,610 stars, MIT, needs API key)
- [LINQ to DB](https://appsgit.com/mcp-servers/linq-to-db): Inspect database schemas and execute SQL queries across multiple database providers with LINQ to DB. (3,332 stars, MIT)
- [Mindwtr](https://appsgit.com/mcp-servers/mindwtr): Task automation via SQLite, desktop Local API, or Mindwtr Cloud; read-only by default. (2,211 stars, AGPL-3.0, needs API key)
- [MCP Memory Service](https://appsgit.com/mcp-servers/mcp-memory-service): Open-source persistent memory for AI agent pipelines (LangGraph, CrewAI, AutoGen) and Claude. (1,988 stars, Apache-2.0)

---

Canonical page: https://appsgit.com/mcp-servers/mcp-neo4j-cypher
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.