Mistake on this page?
Report an issue in GitHub or email us

Install or upgrade

Mbed CLI 2 is a Python package called mbed-tools, so you can install it with pip.

Tip: We recommend using a virtual environment to avoid Python dependency conflicts.



Pip requires some header files and static libraries. Install the Python development package to get them:

For example on Ubuntu:

sudo apt-get install python3-dev

Use pip to install:

  • To install the latest release:

    python -m pip install mbed-tools
  • To install a specific version:

    python -m pip install mbed-tools==<version number in major.minor.patch format>
  • To install a pre-release or development version:

    python -m pip install mbed-tools --pre

Tip: On a Unix-like system, ensure that ~/.local/bin is accessible and in your path.


Use pip to upgrade your version:

python -m pip install mbed-tools --upgrade
Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.