Neo4j MCP Server for Cursor

Name: Neo4j MCP Server for Cursor
Author: ezedinff

@ezedinff

About Neo4j MCP Server for Cursor

A Cursor MCP (Model Context Protocol) server that enables seamless interaction with Neo4j databases directly from the Cursor IDE.

#ai #mcp #cursor

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "neo4j-mcp": {
      "command": "bun",
      "args": [
        "run",
        "index.ts"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Neo4j MCP Server for Cursor?

The Neo4j MCP Server for Cursor is a Model Context Protocol server that allows users to interact with Neo4j databases directly from the Cursor IDE. It enables executing Cypher queries, retrieving database metrics, and monitoring connection status through standard MCP tools.

How to use Neo4j MCP Server for Cursor?

Clone the repository, install dependencies with Bun (v1.0.0+), and configure Neo4j credentials in a .env file. The server uses stdio transport and is launched by Cursor. Six tools are available: connect with explicit credentials, connect with environment variables, execute a Cypher query, get database information, get connection status, and disconnect. For testing, run bun run index.ts or ./run-mcp-server.sh.

Key features of Neo4j MCP Server for Cursor

Connect to local or remote Neo4j databases
Execute Cypher queries with optional parameters
Transform Neo4j data types to JavaScript objects
Retrieve database version, node counts, and labels
Monitor connection state and diagnostics
Manage credentials securely via environment variables

Use cases of Neo4j MCP Server for Cursor

Run Cypher queries to explore a graph database while coding
Inspect database schema (labels, relationship types) without leaving Cursor
Automate integration tests that interact with a Neo4j database
Monitor database health and connection status during development

FAQ from Neo4j MCP Server for Cursor

What are the prerequisites for using Neo4j MCP Server for Cursor?

Bun v1.0.0 or higher and a Neo4j database (local or remote) are required. A Docker Compose file is included to run Neo4j locally.

How do I connect to a Neo4j database?

You can connect using explicit credentials (URI, username, password) or by setting environment variables (NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD, NEO4J_DATABASE) in a .env file.