v1.4.1

v1.4.1 - 2026-02-20

Patch

• Allow unauthenticated "ping" requests. Enable with the NEO4J_HTTP_ALLOW_UNAUTHENTICATED_PING environment
  variable or the --neo4j-http-allow-unauthenticated-ping CLI flag.

• Fix missing version string in HTTP metrics.

• Fixed the type in argSlice preventing neo4j-http-auth-header-name from being parsed as expected.

v1.4.0

v1.4.0 - 2026-02-06

Minor

• Add support for custom auth header configuration.

Patch

• Allow trailing slash for /mcp path

v1.3.0

v1.3.0 - 2026-02-03

Minor

• The NEO4J_MCP_TRANSPORT environment variable is now deprecated in favour of NEO4J_TRANSPORT_MODE.

v1.2.0

v1.2.0 - 2026-01-20

Minor

• Added bearer token support for MCP server.
• Telemetry events are now also emitted when the server is executed in HTTP mode. Previously only STDIO mode supported telemetry.

Patch

• Added support for GDS tools when HTTP mode is in use. GDS requirements are verified in lazy mode when credentials become available.

v1.1.1

v1.1.1 - 2026-01-07

Patch

• Install CA certificates in Dockerfile to support HTTPS connections.

v1.1.0

v1.1.0 - 2025-12-16

Minor

• In this release, we add the support for HTTP transport mode.

• HTTP Server Mode: Run neo4j-mcp as an HTTP server instead of STDIO. Use --neo4j-transport-mode http to enable it. Configure the server address with --neo4j-http-host 127.0.0.1 --neo4j-http-port 8080.
• Per-Request Authentication & CORS: Each HTTP request authenticates independently. Control which clients can connect using --neo4j-http-allowed-origins https://client.example.com,https://app.example.com for granular access control.
• Secure HTTPS Connections: Enable TLS/HTTPS for production. Use --neo4j-http-tls-enabled true --neo4j-http-tls-cert-file /path/to/cert --neo4j-http-tls-key-file /path/to/key to encrypt server communications.

v1.0.1

v1.0.1 - 2025-11-28

Patch

• Removed "params" argument from the list of required arguments for tools such as read-cypher/write-cypher.

v1.0.0

v1.0.0 - 2025-11-24

Major

• Official 1.0.0 GA release of the Neo4j MCP server.

Minor

• The get-schema tool now returns a more concise, token-efficient JSON output. The sample-size parameter is now configured via the NEO4J_SCHEMA_SAMPLE_SIZE environment variable. Alternatively the argument --neo4j-schema-sample-size can be used.

Patch

• Extend analytics insights with dbms.components information such as "Edition", "Neo4j version", "MCP Version", "Cypher Version"

v0.5.0

v0.5.0 - 2025-11-20

Minor

• The server now performs comprehensive pre-flight checks to verify your environment, including Neo4j connection, query capabilities, APOC installation, and will gracefully start without GDS-specific tools if the GDS library is not found.
• Added unified structured logging with slog. Configurable via NEO4J_LOG_LEVEL and NEO4J_LOG_FORMAT environment variables
• Added CLI flags for configuration (--neo4j-uri, --neo4j-username, --neo4j-password, --neo4j-database, --neo4j-read-only, --neo4j-telemetry) that override environment variables. NEO4J_URI, NEO4J_USERNAME, and NEO4J_PASSWORD are now required environment variables (no defaults provided).

v0.4.1

v0.4.1 - 2025-11-18

Patch

• Fixed the incorrect metrics used to identify when users are coming from Aura databases