Query modules overview
Memgraph supports extending the query language with user-written procedures in
C, C++, Python, and Rust. These procedures are grouped into
modules - query modules files (either
Some query modules are built-in, and others, like those that can help you solve complex graph issues, are available as part of the MAGE library you can add to your Memgraph installation. The library is already included if you are using Memgraph Platform or Memgraph MAGE Docker images to run Memgraph.
You can also implement custom query modules. Every single Memgraph installation
comes with the
py_example.py query modules located in the
/usr/lib/memgraph/query_modules directory. They were provided as examples of
query modules for you to examine and learn from.
Each query module file corresponds to one query module, and file names are
mapped as query module names. For example,
example.so will be mapped as
example module, and
py_example.py will be mapped as
py_example module. If
each module file has a procedure called
procedure defined, those procedures
would be mapped in the Cypher query language as
Regardless of where they come from and who wrote them, all modules need to be loaded into Memgraph so that they can be called while querying the database. They are either loaded automatically when Memgraph starts or manually if they were added while Memgraph was already running.
You can also inspect and develop query modules in Memgraph Lab (v2.0 and newer). Just navigate to Query Modules.
Screenshot of Query Modules from Memgraph Lab
Once you start Memgraph, it will attempt to load query modules from all .so and
.py files from the default directories. MAGE modules are located at
/usr/lib/memgraph/query_modules and custom modules developed via Memgraph Lab at
To learn more about query modules, take a look at the following guides:
- Available query modules - MAGE
- Implement custom query modules using:
- Load and call query modules
- Manage module files from Memgraph
The open-source repository MAGE (Memgraph Advanced Graph Extensions) contains all currently implemented query modules. For more information on all the available graph algorithms and installation instructions, check out the MAGE documentation page.
If you need an additional Python library not included with Memgraph, check out the guide on how to install it.