Skip to main content
Glama
Sign In
Neo4j MCP Server

Neo4j MCP Server

by Dhakshnamoorthi146
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

Neo4j MCP Server

A Model Context Protocol server that exposes a Neo4j graph database as tools an AI agent can call. It serves the MCP protocol over HTTP, so it can be reached by any MCP client — including a Databricks Unity Catalog MCP connection.

Tools

Tool

Purpose

read_neo4j

Run a read-only Cypher query (MATCH / RETURN). Write keywords are rejected.

write_neo4j

Run a write Cypher query (CREATE / MERGE / SET / DELETE).

get_neo4j_schema

Return the graph schema — node labels, relationship types, properties, and connection patterns. Call this first so queries use the right labels/relationships instead of guessing.

Related MCP server: Neo4j MCP Server

Requirements

Setup

npm install
cp .env.example .env      # then fill in your Neo4j credentials + a secret token
npm run build
npm start                 # serves on http://localhost:3000

Endpoints:

  • GET /health — liveness check

  • POST /mcp — the MCP endpoint (requires Authorization: Bearer <MCP_SECRET_TOKEN>)

Optional: npm run seed loads sample data into Neo4j.

Environment

See .env.example. Copy it to .env and fill in:

Variable

Description

NEO4J_URI

Bolt/Aura connection URI, e.g. neo4j+s://<id>.databases.neo4j.io

NEO4J_USERNAME

Neo4j username

NEO4J_PASSWORD

Neo4j password

PORT

HTTP port (default 3000)

MCP_SECRET_TOKEN

Bearer token clients must present on /mcp

.env is git-ignored. Never commit real credentials.

Exposing it to Databricks (or any remote client)

The server listens on localhost. To let a remote MCP client reach it during development, expose the port with a tunnel:

ngrok http 3000

Then register the public URL as a UC HTTP/MCP connection in Databricks, using Authorization: Bearer <MCP_SECRET_TOKEN>. For production, host the server on a reachable machine instead of a tunnel.

Project layout

neo4j-mcp-server/
├── src/
│   ├── index.ts   # the MCP server (tools + HTTP transport)
│   └── seed.ts    # optional sample-data seeder
├── package.json
├── tsconfig.json
├── .env.example
└── .gitignore

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Neo4j MCP Server

      vpro1032
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Neo4j graph databases through natural language, supporting Cypher queries, schema management, data manipulation, and graph algorithms.
      MIT

    • Neo4j MCP

      cxt9
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables LLMs to interact with Neo4j graph databases using natural language to execute Cypher queries and introspect database schemas. It supports both read and write operations for local, Docker, and cloud-based instances like Neo4j Aura.
      MIT

    • Neo4j MCP Server

      alvaropaco
      A
      license
      A
      quality
      C
      maintenance
      MCP server for Neo4j that provides abstract graph operations for LLMs, enabling safe and consistent interaction with Neo4j databases through tools like search, insert, update, delete, and schema introspection.
      8
      MIT