Neo4j MCP Server for Cursor
About
Connects to Neo4j graph databases with ability to use GDS functions ( when available), a read only mode , and set the sample size for schema detection
Explore
- Connect to Neo4j databases
- Execute Cypher queries and retrieve results
- Transform Neo4j-specific data types to standard JavaScript objects
- Uses the official MCP SDK with stdio transport for seamless integration with Cursor
- Support for environment variables for secure credential management
- Retrieve detailed database information and metrics
- Monitor connection status and diagnostics
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Neo4j MCP Server for CursorCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Bun (v1.0.0 or higher)
- Neo4j database (local or remote)
This project includes a Docker Compose configuration to easily run Neo4j in a container:
1. Make sure you have Docker and Docker Compose installed.
2. Start Neo4j using Docker Compose:
docker-compose up -d
3. Access the Neo4j Browser at http://localhost:7474
- Default username: neo4j
- Default password: your_password (as specified in the docker-compose.yml)
4. To stop Neo4j:
docker-compose down
5. To stop Neo4j and remove all data:
docker-compose down -v
> Note: The default password in docker-compose.yml is set to your_password. For production use, change this to a secure password and update your .env file accordingly.
Connects to a Neo4j database using credentials from environment variables.
No parameters required.
The following environment variables can be set in a .env file:
| Variable | Description | Default |
|----------|-------------|---------|
| NEO4J_URI | Neo4j database URI | neo4j://localhost:7687 |
| NEO4J_USERNAME | Neo4j database username | neo4j |
| NEO4J_PASSWORD | Neo4j database password | (empty) |
| NEO4J_DATABASE | Neo4j database name | (default database) |
| NODE_ENV | Environment (development/production) | development |
You can run the server using the provided shell script:
./run-mcp-server.sh
This script:
- Sets the working directory to the script's location
- Creates a logs directory if it doesn't exist
- Runs the server using Bun and logs output to logs/mcp-server.log
> Note: The script requires Bun to be installed and available in your PATH.
The MCP server exposes the following tools:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"neo4j mcp server for cursor": {
"neo4j-mcp": {
"command": "bun",
"args": [
"run",
"index.ts"
]
}
}
}
}McpServers
{
"neo4j-mcp": {
"command": "bun",
"args": [
"run",
"index.ts"
]
}
}A Cursor MCP (Model Context Protocol) server that enables seamless interaction with Neo4j databases directly from the Cursor IDE.
Features
- Connect to Neo4j databases
- Execute Cypher queries and retrieve results
- Transform Neo4j-specific data types to standard JavaScript objects
- Uses the official MCP SDK with stdio transport for seamless integration with Cursor
- Support for environment variables for secure credential management
- Retrieve detailed database information and metrics
- Monitor connection status and diagnostics
Prerequisites
- Bun (v1.0.0 or higher)
- Neo4j database (local or remote)
Running Neo4j with Docker Compose
This project includes a Docker Compose configuration to easily run Neo4j in a container:
1. Make sure you have Docker and Docker Compose installed.
2. Start Neo4j using Docker Compose:
docker-compose up -d
3. Access the Neo4j Browser at http://localhost:7474
- Default username: neo4j
- Default password: your_password (as specified in the docker-compose.yml)
4. To stop Neo4j:
docker-compose down
5. To stop Neo4j and remove all data:
docker-compose down -v
> Note: The default password in docker-compose.yml is set to your_password. For production use, change this to a secure password and update your .env file accordingly.
Installation
1. Clone this repository:
git clone https://github.com/yourusername/neo4j-mcp.git
cd neo4j-mcp
2. Install dependencies:
bun install
3. Configure environment variables:
Create a .env file in the root directory with your Neo4j credentials:
NEO4J_URI=neo4j://localhost:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=your_password
NEO4J_DATABASE=neo4j
NODE_ENV=development
Usage
Starting the Server
The server uses stdio transport for communication with Cursor, so it should be started by Cursor itself. However, you can test it manually:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
