A simple Neo4j MCP server that allows you to run Cypher queries against a Neo4j database.
Connect Runs on your machine
claude mcp add mcp-neo4j-cypher -e NEO4J_URI=<NEO4J_URI> -e NEO4J_USERNAME=<NEO4J_USERNAME> -e NEO4J_PASSWORD=<NEO4J_PASSWORD> -e NEO4J_DATABASE=<NEO4J_DATABASE> -e NEO4J_NAMESPACE=<NEO4J_NAMESPACE> -e NEO4J_RESPONSE_TOKEN_LIMIT=<NEO4J_RESPONSE_TOKEN_LIMIT> -e NEO4J_READ_TIMEOUT=<NEO4J_READ_TIMEOUT> -e NEO4J_READ_ONLY=<NEO4J_READ_ONLY> -e NEO4J_SCHEMA_SAMPLE_SIZE=<NEO4J_SCHEMA_SAMPLE_SIZE> -- uvx mcp-neo4j-cypher==0.5.1{
"mcpServers": {
"mcp-neo4j-cypher": {
"command": "uvx",
"args": [
"mcp-neo4j-cypher==0.5.1"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"NEO4J_DATABASE": "<NEO4J_DATABASE>",
"NEO4J_NAMESPACE": "<NEO4J_NAMESPACE>",
"NEO4J_RESPONSE_TOKEN_LIMIT": "<NEO4J_RESPONSE_TOKEN_LIMIT>",
"NEO4J_READ_TIMEOUT": "<NEO4J_READ_TIMEOUT>",
"NEO4J_READ_ONLY": "<NEO4J_READ_ONLY>",
"NEO4J_SCHEMA_SAMPLE_SIZE": "<NEO4J_SCHEMA_SAMPLE_SIZE>"
}
}
}
}{
"mcpServers": {
"mcp-neo4j-cypher": {
"command": "uvx",
"args": [
"mcp-neo4j-cypher==0.5.1"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"NEO4J_DATABASE": "<NEO4J_DATABASE>",
"NEO4J_NAMESPACE": "<NEO4J_NAMESPACE>",
"NEO4J_RESPONSE_TOKEN_LIMIT": "<NEO4J_RESPONSE_TOKEN_LIMIT>",
"NEO4J_READ_TIMEOUT": "<NEO4J_READ_TIMEOUT>",
"NEO4J_READ_ONLY": "<NEO4J_READ_ONLY>",
"NEO4J_SCHEMA_SAMPLE_SIZE": "<NEO4J_SCHEMA_SAMPLE_SIZE>"
}
}
}
}{
"servers": {
"mcp-neo4j-cypher": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-neo4j-cypher==0.5.1"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>",
"NEO4J_DATABASE": "<NEO4J_DATABASE>",
"NEO4J_NAMESPACE": "<NEO4J_NAMESPACE>",
"NEO4J_RESPONSE_TOKEN_LIMIT": "<NEO4J_RESPONSE_TOKEN_LIMIT>",
"NEO4J_READ_TIMEOUT": "<NEO4J_READ_TIMEOUT>",
"NEO4J_READ_ONLY": "<NEO4J_READ_ONLY>",
"NEO4J_SCHEMA_SAMPLE_SIZE": "<NEO4J_SCHEMA_SAMPLE_SIZE>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
NEO4J_URIRequired | Neo4j connection URI |
NEO4J_USERNAMERequired | Neo4j username |
NEO4J_PASSWORDRequired, secret | Neo4j password |
NEO4J_DATABASEOptional | Neo4j database name |
NEO4J_NAMESPACEOptional | Tool namespace prefix |
NEO4J_RESPONSE_TOKEN_LIMITOptional | Maximum tokens for read query responses |
NEO4J_READ_TIMEOUTOptional | Timeout in seconds for read queries |
NEO4J_READ_ONLYOptional | Allow only read-only queries (true/false) |
NEO4J_SCHEMA_SAMPLE_SIZEOptional | Schema sample size |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 7 Nov 2025 |
| Last updated | 7 Nov 2025 |
| Registry name | io.github.neo4j-contrib/mcp-neo4j-cypher |
More databases servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.