A simple Neo4j MCP server that allows you to run Cypher queries against a Neo4j database.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add neo4j-cypher --env NEO4J_URI='<NEO4J_URI>' --env NEO4J_USERNAME='<NEO4J_USERNAME>' --env NEO4J_PASSWORD='<NEO4J_PASSWORD>' -- uvx mcp-neo4j-cypher~/.codex/config.toml
[mcp_servers.neo4j-cypher]
command = "uvx"
args = ["mcp-neo4j-cypher"]
env = { NEO4J_URI = "<NEO4J_URI>", NEO4J_USERNAME = "<NEO4J_USERNAME>", NEO4J_PASSWORD = "<NEO4J_PASSWORD>" }
# codex mcp add neo4j-cypher --env NEO4J_URI='<NEO4J_URI>' --env NEO4J_USERNAME='<NEO4J_USERNAME>' --env NEO4J_PASSWORD='<NEO4J_PASSWORD>' -- uvx mcp-neo4j-cypher~/.cursor/mcp.json
{
"mcpServers": {
"neo4j-cypher": {
"command": "uvx",
"args": [
"mcp-neo4j-cypher"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"neo4j-cypher": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-neo4j-cypher"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"neo4j-cypher": {
"command": "uvx",
"args": [
"mcp-neo4j-cypher"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"neo4j-cypher": {
"command": "uvx",
"args": [
"mcp-neo4j-cypher"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"neo4j-cypher": {
"command": "uvx",
"args": [
"mcp-neo4j-cypher"
],
"env": {
"NEO4J_URI": "<NEO4J_URI>",
"NEO4J_USERNAME": "<NEO4J_USERNAME>",
"NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
}
}
}
}Environment variables
NEO4J_URINEO4J_USERNAMENEO4J_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.