Skip to main content
Version: Unreleased 🚧

Querying with mgconsole

The easiest way to execute Cypher queries against Memgraph is by using Memgraph's command-line tool, mgconsole.

1. Install mgconsole


If you are using the Memgraph Platform Docker image (memgraph/memgraph-platform), mgconsole will start automatically when you run the container. You can skip the installation step and continue with executing Cypher queries.

1. If you installed Memgraph using Docker, you can run the client from your Docker image. First, you need to find the CONTAINER_ID of your Memgraph container:

docker ps

2. Once you know the CONTAINER_ID, find the IP address of the container by executing:

docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' CONTAINER_ID

3. Now, you can start mgconsole by running the following command:

docker run -it --entrypoint=mgconsole memgraph --host CONTAINER_IP

2. Execute a Cypher query

After the client has started, it should present a command prompt similar to:

mgconsole X.X
Connected to 'memgraph://'
Type :help for shell usage
Quit the shell by typing Ctrl-D(eof) or :quit

At this point, it is possible to execute openCypher queries on Memgraph. Each query needs to end with the ; (semicolon) character. For example:

CREATE (u:User {name: "Alice"})-[:Likes]->(m:Software {name: "Memgraph"});

The above will create 2 nodes in the database, one labeled "User" with name "Alice" and the other labeled "Software" with name "Memgraph". It will also create a relationship that "Alice" likes "Memgraph".

To find created nodes and relationships, execute the following query:

MATCH (u:User)-[r]->(x) RETURN u, r, x;