Skip to main content
Version: Unreleased ๐Ÿšง

Python quick start

At the end of this guide, you will have created a simple Python Hello, World! program that connects to the Memgraph database and executes simple queries.


To follow this guide, you will need:

  • A running Memgraph instance. If you need to set up Memgraph, take a look at the Installation guide.
  • The pymgclient driver. A Memgraph database adapter for the Python programming language.
  • A basic understanding of graph databases and the property graph model.

Basic setup#

We'll be using a Python program to demonstrate how to connect to a running Memgraph database instance.

Let's jump in and connect a simple program to Memgraph.

1. Create a new directory for your program, for example, /memgraph_python and position yourself in it.
2. Create a new Python script and name it Add the following code to it:

import mgclient
# Make a connection to the databaseconnection = mgclient.connect(host='', port=7687)
# Create a cursor for query executioncursor = connection.cursor()
# Delete all nodes and relationshipsquery = "MATCH (n) DETACH DELETE n"
# Execute the querycursor.execute(query)
# Create a node with the label FirstNode and message property with the value "Hello, World!"query = """CREATE (n:FirstNode)           SET n.message = '{message}'           RETURN 'Node '  + id(n) + ': ' + n.message""".format(message="Hello, World!")
# Execute the querycursor.execute(query)
# Fetch one row of query resultsrow = cursor.fetchone()
# Print the first member in rowprint(row[0])
Note for Docker users

If the program fails to connect to a Memgraph instance that was started with Docker, you may need to use a different IP address (not the default localhost/ to connect to the instance.

You can find the CONTAINER ID with docker ps and use it in the following command to retrieve the address:

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

3. Now, you can run the application with the following command:

python ./

You should see an output similar to the following:

Node 1: Hello, World!

Where to next?#

For real-world examples of how to use Memgraph, we suggest you take a look at the Tutorials page. You can also browse through the Database functionalities section to get an overview of all the functionalities Memgraph offers.