Neo4j

neo4j-server-remote is an MCP server that enables graph database interactions with Neo4j through either Server-Sent Events (SSE) or STDIO transport. You can execute Cypher queries, explore graph structures, and remotely connect to Neo4j databases from an MCP client.

How to use

You interact with the server from an MCP client by selecting either the SSE endpoint or the STDIO mode, then issuing Cypher queries and commands through the available MCP tools. Use the read tool to fetch data, the write tool to update the graph, and the schema tool to inspect the graph structure. You can also run the demo prompt to generate sample schemas and data. For read operations, provide a Cypher read query; for updates, provide a Cypher update query; and for schema exploration, request the graph’s node types and relationships.

How to install

{
  "mcpServers": {
    "neo4j_remote": {
      "type": "http",
      "name": "neo4j_remote",
      "url": "http://0.0.0.0:8543/sse",
      "args": []
    }
  }
}

To run in STDIO mode, use the local runtime command shown below along with the same connection details. Ensure Neo4j is running and accessible at bolt://localhost:7687 with the database neo4j.

{
  "mcpServers": {
    "neo4j_local": {
      "type": "stdio",
      "name": "neo4j_local",
      "command": "uv",
      "args": [
        "run",
        "/absolute/path/to/neo4j_server_remote.py",
        "--url",
        "bolt://localhost:7687",
        "--username",
        "neo4j",
        "--password",
        "neo4j123",
        "--database",
        "neo4j",
        "--mode",
        "stdio"
      ]
    }
  }
}

Additional notes

Prerequisites include Python 3.12+ for the server and a running Neo4j instance accessible at the connection URLs provided in the commands above. If you plan to run in SSE mode, you will typically connect using the HTTP URL and port configured for SSE. In STDIO mode, you invoke the local runtime with the specified script path and arguments.

Troubleshooting and tips

• Verify Neo4j is running and accessible before starting the MCP server.
• Confirm that you are using the correct mode (SSE or STDIO) in your MCP client configuration.
• If you encounter authentication issues, double-check the username and password provided in the connection command.
• Use the demo prompt (mcp-demo) to seed the database with sample data and schemas for quick testing.

Available tools

read-neo4j-cypher

Execute Cypher read queries to read data from the database. Input: query (string). Returns: an array of objects with query results.

write-neo4j-cypher

Execute updating Cypher queries. Input: query (string). Returns: a result summary with counts like nodes_updated, relationships_created, etc.

get-neo4j-schema

Retrieve a list of all node types, their attributes, and relationships in the graph database. No input required. Returns: a list of node labels with attributes and relationships dictionaries.