The mtools collection is written in Python, and most of the tools only use the standard packages shipped with Python. The tools are currently tested with Python 2.7 and 3.6.

Some of the tools have additional dependencies, which are listed under the specific tool’s section.

The mtools utilities are only tested with currently supported (non End-of-Life) versions of the MongoDB server. As of April 2018, that includes MongoDB 3.2 or newer.



You need to have Python 2.7.x or 3.6.x installed in order to use mtools. Other versions of Python are not currently supported.

To check your Python version, run python --version on the command line.

Installation with pip#

The easiest way to install mtools is via pip. From the command line, run:

pip install mtools

You need to have pip installed for this to work. If you don’t have pip installed yet, try sudo easy_install pip from the command line first, or follow the instructions provided on the pip installation page.

Depending on your user rights, pip may complain about not having permissions to install into the system directory.

In that case, you either need to add sudo in front of the pip command to install into a system directory, or append --user to install into your home directory.

Some mtools scripts have additional Dependencies.

Installation from source#

If pip is not available and you want to install mtools from source, you can get the source code by cloning the mtools github repository:

git clone git://

Or download the tarball from PyPI and extract it with:

tar xzvf mtools-<version>.tar.gz

Then cd into the mtools directory and run:

sudo python install

This will install mtools into your Python’s site-packages folder, create links to the scripts and set everything up. You should now be able to use all the scripts directly from the command line.


The full list of requirements (some of which are already included in the Python standard library) can be found in the requirements.txt file.

To install all dependencies for full feature support, run:

pip install mtools[all]

To install dependencies for a subset of mtools utilities, specify one or more script names as a comma-separated list:

pip install mtools[mlaunch,mloginfo]


required for mlaunch

mlaunch uses psutil to manage starting, stopping, and finding MongoDB processes.


required for mlaunch

pymongo is MongoDB’s official Python driver. mlaunch uses this to configure and query local MongoDB deployments.


required for mplotqueries

matplotlib is a python 2D plotting library which produces figures and graphs in a variety of formats and interactive environments across platforms.


required for matplotlib (in mplotqueries)

numpy is a Python module for scientific computing and numerical calculations.