io.github.neo4j-contrib/mcp-neo4j-memory
MCP Neo4j Knowledge Graph Memory Server
io.github.neo4j-contrib/mcp-neo4j-memory · Repository · version 1.0.0 · 979 stars · listed from registry
Install
The sweep installs into a clean prefix, but this is the command a user would run:
uvx mcp-neo4j-memory
Needs credentials: NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD. The probe used placeholder values, so an amber needs credentials result below means the server asked for the real ones, not that it is broken. Maintainers: how to go green.
Results by platform
Linux
needs credentials2026-08-16 · probed over pypi1 recorded run, oldest first.
handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Installed 71 packages in 252ms
Warning: No Neo4j database provided. Using default: neo4j
Warning: No transport type provided. Using default: stdio
Traceback (most recent call last):
File "/home/runner/.cache/uv/archive-v0/aTbqLt7oEnKdBJi3/bin/mcp-neo4j-memory", line 12, in <module>
sys.exit(main())
~~~~^^
File "/home/runner/.cache/uv/archive-v0/aTbqLt7oEnKdBJi3/lib/python3.13/site-packages/mcp_neo4j_memory/__init__.py", line 29, in main
asyncio.run(server.main(**config))
~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^
File "/home/runner/.local/share/uv/python/cpython-3.13.15-linux-x86_64-gnu/lib/python3.13/asyncio/runners.py", line 196, in run
return runner.run(main)
~~~~~~~~~~^^^^^^
File "/home/runner/.local/share/uv/python/cpython-3.13.15-linux-x86_64-gnu/lib/python3.13/asyncio/runners.py", line 119, in run
return self._loop.run_until_complete(task)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^
File "/home/runner/.local/share/uv/python/cpython-3.13.15-linux-x86_64-gnu/lib/python3.13/asyncio/base_events.py", line 726, in run_until_complete
return future.result()
~~~~~~~~~~~~~^^
File "/home/runner/.cache/uv/archive-v0/aTbqLt7oEnKdBJi3/lib/python3.13/site-packages/mcp_neo4j_memory/server.py", line 427, in main
neo4j_driver = AsyncGraphDatabase.driver(
neo4j_uri,
auth=(neo4j_user, neo4j_password),
database=neo4j_database
)
File "/home/runner/.cache/uv/archive-v0/aTbqLt7oEnKdBJi3/lib/python3.13/site-packages/neo4j/_async/driver.py", line 194, in driver
driver_type, security_type, parsed = parse_neo4j_uri(uri)
~~~~~~~~~~~~~~~^^^^^
File "/home/runner/.cache/uv/archive-v0/aTbqLt7oEnKdBJi3/lib/python3.13/site-packages/neo4j/_api.py", line 103, in parse_neo4j_uri
raise ConfigurationError(
...<4 lines>...
)
neo4j.exceptions.ConfigurationError: URI scheme '' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]
macOS
needs credentials2026-08-16 · probed over pypi1 recorded run, oldest first.
handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Installed 69 packages in 413ms
Warning: No Neo4j database provided. Using default: neo4j
Warning: No transport type provided. Using default: stdio
Traceback (most recent call last):
File "/Users/runner/.cache/uv/archive-v0/vl0i2wXtegUCRbu-/bin/mcp-neo4j-memory", line 12, in <module>
sys.exit(main())
~~~~^^
File "/Users/runner/.cache/uv/archive-v0/vl0i2wXtegUCRbu-/lib/python3.14/site-packages/mcp_neo4j_memory/__init__.py", line 29, in main
asyncio.run(server.main(**config))
~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/homebrew/Cellar/[email protected]/3.14.6/Frameworks/Python.framework/Versions/3.14/lib/python3.14/asyncio/runners.py", line 205, in run
return runner.run(main)
~~~~~~~~~~^^^^^^
File "/opt/homebrew/Cellar/[email protected]/3.14.6/Frameworks/Python.framework/Versions/3.14/lib/python3.14/asyncio/runners.py", line 128, in run
return self._loop.run_until_complete(task)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^
File "/opt/homebrew/Cellar/[email protected]/3.14.6/Frameworks/Python.framework/Versions/3.14/lib/python3.14/asyncio/base_events.py", line 719, in run_until_complete
return future.result()
~~~~~~~~~~~~~^^
File "/Users/runner/.cache/uv/archive-v0/vl0i2wXtegUCRbu-/lib/python3.14/site-packages/mcp_neo4j_memory/server.py", line 427, in main
neo4j_driver = AsyncGraphDatabase.driver(
neo4j_uri,
auth=(neo4j_user, neo4j_password),
database=neo4j_database
)
File "/Users/runner/.cache/uv/archive-v0/vl0i2wXtegUCRbu-/lib/python3.14/site-packages/neo4j/_async/driver.py", line 194, in driver
driver_type, security_type, parsed = parse_neo4j_uri(uri)
~~~~~~~~~~~~~~~^^^^^
File "/Users/runner/.cache/uv/archive-v0/vl0i2wXtegUCRbu-/lib/python3.14/site-packages/neo4j/_api.py", line 103, in parse_neo4j_uri
raise ConfigurationError(
...<4 lines>...
)
neo4j.exceptions.ConfigurationError: URI scheme '' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]
Windows
needs credentials2026-08-16 · probed over pypi1 recorded run, oldest first.
handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Installed 72 packages in 23.25s
Warning: No Neo4j database provided. Using default: neo4j
Warning: No transport type provided. Using default: stdio
Traceback (most recent call last):
File "<frozen runpy>", line 198, in _run_module_as_main
File "<frozen runpy>", line 88, in _run_code
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\p7inp2LPcd7qvwsO\Scripts\mcp-neo4j-memory.exe\__main__.py", line 10, in <module>
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\p7inp2LPcd7qvwsO\Lib\site-packages\mcp_neo4j_memory\__init__.py", line 29, in main
asyncio.run(server.main(**config))
File "C:\hostedtoolcache\windows\Python\3.12.10\x64\Lib\asyncio\runners.py", line 195, in run
return runner.run(main)
^^^^^^^^^^^^^^^^
File "C:\hostedtoolcache\windows\Python\3.12.10\x64\Lib\asyncio\runners.py", line 118, in run
return self._loop.run_until_complete(task)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\hostedtoolcache\windows\Python\3.12.10\x64\Lib\asyncio\base_events.py", line 691, in run_until_complete
return future.result()
^^^^^^^^^^^^^^^
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\p7inp2LPcd7qvwsO\Lib\site-packages\mcp_neo4j_memory\server.py", line 427, in main
neo4j_driver = AsyncGraphDatabase.driver(
^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\p7inp2LPcd7qvwsO\Lib\site-packages\neo4j\_async\driver.py", line 194, in driver
driver_type, security_type, parsed = parse_neo4j_uri(uri)
^^^^^^^^^^^^^^^^^^^^
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\p7inp2LPcd7qvwsO\Lib\site-packages\neo4j\_api.py", line 103, in parse_neo4j_uri
raise ConfigurationError(
neo4j.exceptions.ConfigurationError: URI scheme '' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]
Badge
Paste this into the project README to show the current result:
[](https://doesitinstall.com/s/io.github.neo4j-contrib__mcp-neo4j-memory.html)