Navigation

Installing the Database Tools on macOS

The MongoDB Database Tools are a suite of command-line utilities for working with MongoDB. Use this guide to install the Database Tools on the macOS platform.

Starting with MongoDB 4.4, the MongoDB Database Tools are now released separately from the MongoDB Server and use their own versioning, with an initial version of 100.0.0. Previously, these tools were released alongside the MongoDB Server and used matching versioning.

For documentation on the MongoDB 4.2 or earlier versions of these tools, reference the MongoDB Server Documentation for that version of the tool:

Note
Quick links to older documentation

MongoDB Database Tools version 100.3.1 supports the following versions of the MongoDB server:

  • MongoDB 4.4
  • MongoDB 4.2
  • MongoDB 4.0
  • MongoDB 3.6

While the tools may work on earlier versions of MongoDB server, any such compatibility is not guaranteed.

The MongoDB Database Tools version 100.3.1 are supported on macOS 10.12 or later.

The MongoDB Database Tools can be installed with the third party Homebrew package manager, or downloaded as a .tgz archive. Select the tab below depending on your desired installation method:

Note

Starting with MongoDB 4.4.1, installing the MongoDB Server via Homebrew also installs the Database Tools. The following command will determine if the Database Tools are already installed on your system:

brew list | grep mongodb-database-tools
1

macOS does not include the Homebrew brew package by default. Install brew using the official Homebrew installation instructions.

2

In your macOS Terminal, run the following command to download the official MongoDB Homebrew formulae for MongoDB and the Database Tools:

brew tap mongodb/brew
3

In your macOS Terminal, run the following command to install the MongoDB Database Tools:

brew install mongodb-database-tools
Tip

Once installed, you can later update the Database Tools with:

brew upgrade mongodb-database-tools
4

Once installed, you can run any of the Database Tools directly from your macOS Terminal. Consult the reference page for the specific tool you wish to use for its full syntax and usage.

Give Feedback