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 - 2025-11-28

Patch

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

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 - 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 - 2025-11-18

Patch

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

v0.4.0 - 2025-11-14

Minor

• Added opt-out telemetry to collect anonymous usage data for product improvement.

Patch

• Reduced the get-schema output footprint by removing the empty and unused labels JSON entry.
• Adds a help command available using -h or --help.

v0.3.1 - 2025-10-24

Patch

• Add NEO4J_READ_ONLY env var to enable read-only mode. When enabled, only tools annotated as read-only are registered.

v0.3.0 - 2025-10-16

Minor

• Introduces a new tool, list-gds-procedures, to list available Graph Data Science (GDS) procedures in a Neo4j database.
  This enhances the user experience within Neo4j MCP for GDS tasks by enabling LLMs to discover and utilize GDS graph algorithms.

v0.2.0 - 2025-10-06

Minor

• Renamed "run-cypher" to "write-cypher" and added "read-cypher".
  The new read-cypher enforces read-only Cypher queries and only accepts queries
  that do not modify data. It explicitly disallows admin/schema commands,
  write queries, and profiling queries using the EXPLAIN keyword.

v0.1.3 - 2025-09-23

Patch

• Enhanced MCP tool annotations by adding title, destructive, idempotent, and open-world hints for get-schema and run-cypher tools to improve client understanding and behavior