Working with MySQL database from Blender

Storing data in a remote database has become common practice in the development of software products. Blender is no exception. Writing scripts and add-ons, the developer may need to access the database to retrieve from it or write to it the necessary information. MySQL today is one of the most common and widely available databases and is well suited for working with Blender.

The interaction between Blender and MySQL database through the Blender Python API is not difficult, but it needs some preparation before stating:

There is no MySQL database connection module (MySQL Connector) in the default Blender package. So it needs to be installed:

  1. Download the MySQL Connector for Python from the official MySQL site:
    1. Follow the link:
    2. In Select Operating System dialog:
      1. Select Platform Independent
    3. Download MySQL Connector module archive: Platform Independent (Architecture Independent), ZIP Archive Python
  2. Unpack downloaded archive to the temporary directory, for example, to the root of drive D:/
  3. From the unpacked distributive from D:/mysql-connector-python-2.1.5/lib/ copy the mysql directory to the Blender lib directory. If Blender is located in C:/Program Files, you need to copy the mysql directory to C:/Program Files/blender-2.78c-windows64/2.78/python/lib/

The module for Blender connection to MySQL is installed, now we can work directly with the database.

Using external IDE PyCharm to work with Blender API or simply in the built-in text editor let’s write some code to access the MySQL database:

  1. Import the necessary modules at first: bpy – to interact with the scene, mysql.connector – to work with the database:

  1. Define parameters for the database connection:

user – the user of the MySQL database. You can specify the administrator – root, or another specially created user.

password – the database user password. Replace _PASSWORD_ with a proper user password.

host – the database location. It can be specified as an address (, ip ( or localhost (the database is hosted on the local computer).

database and table – the name of the database and the table in it.

  1. Create the connection to MySQL and the cursor to execute queries:

  1. Create the database with the specified name (‘blender’) and select it:

  1. Create the table in the selected database:

The table structure consists of one text field “name” with 50 characters length.

  1. Add several different meshes to the scene (UV Sphere, Cube, etc.)
    1. Shift+a – Mesh – …
  2. Add to our script a query which adds the name of the selected mesh to the table created above:

By default, the auto-commit in the mysql connector is disabled, so after performing insert, update, and the same queries we must manually commit them with the commit() command.

If you first enable auto-commit,

you do not need to complete queries with the commit().

  1. To confirm that the name of the selected object correctly stored in the table of our database, we can execute a query that returns the table content:

After this code execution, the contents of the “name” field of the created table will be listed in the Blender system console.

  1. To finish working with MySQL we need to close the cursor and the connection:


The completed text of our script:

To test it, you can consistently select added to the scene meshes, each time after the selection running the script. As a result, the database with the name “blender” will be created, with the table named “test” within, into which several mesh names will be stored. The final output to the Blender system console will look like this: