Skip to content

neo4j-contrib/mcp-neo4j

MCP Data & Storage

Neo4j Labs Model Context Protocol servers

Python Latest mcp-neo4j-cypher-v0.6.0 · 1mo ago Security brief →

Features

  • Convert natural language to Cypher queries for Neo4j databases
  • Store and retrieve personal knowledge‑graph entities across sessions
  • Manage Neo4j Aura cloud instances via AI‑assistant chat
  • Interactively model, validate, and visualize graph data schemas

Recent releases

View all 46 releases →
mcp-neo4j-cypher-v0.6.0 Bug fix

Minor fixes and improvements.

Full changelog

v0.6.0

Fixed

  • Fix startup ImportError caused by pydocket importing FakeConnection from fakeredis>=2.27 — cap fastmcp<2.14 to exclude the pydocket transitive dependency
  • Fix TypeError: str expected, not int in integration tests caused by testcontainers returning an int from get_exposed_port()

Changed

  • Update _is_write_query to use EXPLAIN query instead of regex check

What's Changed

  • refactor: standardize error handling and raise ToolError per MCP policy by @ChinmayPande48 in https://github.com/neo4j-contrib/mcp-neo4j/pull/275
  • update read only check using EXPLAIN by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/281
  • 280 importerror cannot import name fakeconnection from fakeredisaioredis on startup by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/282
  • cypher - prep v0.6.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/283

New Contributors

  • @ChinmayPande48 made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/275

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-gemini-ext-v1.0.1...mcp-neo4j-cypher-v0.6.0

mcp-neo4j-memory-v0.4.5 Breaking risk
Breaking changes
  • Default MCP server endpoint changed from /api/mcp/ to /mcp/
Security fixes
  • Python upgraded from 3.11-slim to 3.13.8-slim
Notable features
  • FastMCP version locked to <3.x
Full changelog

Changed

  • Security upgrade python from 3.11-slim to 3.13.8-slim
  • Change default MCP server endpoint from /api/mcp/ to /mcp/
  • Lock FastMCP version to <3.x

New Contributors

  • @bryankthompson made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/262
  • @AndyHeap-NeoTech made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/200
  • @robsdedude made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/203
  • @Amitk003 made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/266

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.8.2...mcp-neo4j-memory-v0.4.5

mcp-neo4j-cypher-v0.5.3 Breaking risk
Breaking changes
  • Default MCP server endpoint changed from /api/mcp/ to /mcp/
Security fixes
  • Python upgraded from 3.12-slim to 3.13.8-slim
Notable features
  • FastMCP version locked to <3.x
Full changelog

Changed

  • Security upgrade python from 3.12-slim to 3.13.8-slim
  • Update default MCP server endpoint from /api/mcp/ to /mcp/
  • Lock FastMCP version to <3.x

New Contributors

  • @bryankthompson made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/262
  • @AndyHeap-NeoTech made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/200
  • @robsdedude made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/203
  • @Amitk003 made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/266

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.8.2...mcp-neo4j-cypher-v0.5.3

mcp-neo4j-data-modeling-v0.8.2 Breaking risk

Fixed f-string formatting and GitHub Actions workflow bugs.

Full changelog

Fixed

  • Fixed bug in f-string formatting with Pydantic model export in Python v < 3.12
  • Fixed bug in the data modeling Github action that didn't actually test different Python versions due to not specifying the version when executing uv commands.
  • Fix Github action to install dev dependencies correctly with uv sync

Changed

  • Update pyproject.toml to declare dev dependencies correctly (previously using deprecated method)

What's Changed

  • Update data modeling server.json by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/257
  • all - bump mcp registry schema versions to 2025-12-11 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/258
  • data modeling - fix f-string bug and github actions bug by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/260
  • data modeling - prep v0.8.2 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/261

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.8.1...mcp-neo4j-data-modeling-v0.8.2

mcp-neo4j-data-modeling-v0.8.1 Breaking risk
Breaking changes
  • Renamed export_to_neo4j_python_graphrag_package_schema to export_to_neo4j_graphrag_pkg_schema
  • Renamed load_from_neo4j_python_graphrag_package_schema to load_from_neo4j_graphrag_pkg_schema
Full changelog

Fixed

  • Shorten tool name export_to_neo4j_python_graphrag_package_schema to export_to_neo4j_graphrag_pkg_schema to be under 60 characters including the default server name.
  • Shorten tool name load_from_neo4j_python_graphrag_package_schema to load_from_neo4j_graphrag_pkg_schema to be under 60 characters including the default server name.

Added

  • Update README to include new tools and optional return_validated argument to validation tools

What's Changed

  • data modeling - short tool names by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/251
  • data modeling - update readme by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/252
  • Update README.md with Official Neo4j MCP Info by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/253
  • data modeling - prep v0.8.1 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/254
  • cypher and data modeling - update workflows to execute serially by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/255

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.8.0...mcp-neo4j-data-modeling-v0.8.1

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
951
Forks
246
Languages
Python Dockerfile Makefile

Beta — feedback welcome: [email protected]