Modulenotfounderror no module named pymongo [SOLVED]

In this tutorial, we will show you how to solve the error modulenotfounderror no module named pymongo in Python.

This error indicates that the pymongo module is not installed in one’s system or Python environment.

What is Python?

Python is one of the most popular programming languages.

It is used for developing a wide range of applications.

In addition, Python is a high-level programming language that is used by most developers due to its flexibility.

Returning to our issue, we must take a few actions to fix this error.

So, without further ado, let’s move on to our “how to fix this error” tutorial.

How to solve “no module named pymongo” in Python

See also: Typeerror: ‘dict’ object is not callable [SOLVED]

How to install pymongo on macOS or Linux

The following are the steps on how to install pymongo on macOS or Linux.

1. Search for Terminal and open it.
2. Input the command pip install pymongo, then click the enter key.

If you get an error saying that “pip” isn’t found, use the command python -m.

It will look like this: python -m pip install pymongo.

However, if you get a permissions error, use the command sudo pip install pymongo.

Installing the pymongo module on different platforms

The following are the commands you can use to install the pymongo module on your system if you’re using a different platform.

✅ Jupyter Notebook

If you’re using Jupyter Notebook, use the command:

!pip install pymongo

✅ Anaconda

If you’re using Anaconda, use the command:

conda install -c anaconda pymongo

✅ Py Alias

If you’re using py alias, use the command:

py -m pip install pymongo

Commands you might need

• pip list
  
  This command will display all the packages installed on your system, including their versions.

  If you’re using Jupyter Notebook, use the !pip list command.

  However, if you’re using Anaconda, use the command conda list.

• python -m
  
  Include this command in your pip install pymongo command if you get an error message stating that “pip” cannot be found.

  Example: python -m pip install pymongo

  However, if you’re using Python 3, use the command python3 -m pip install pymongo.

• pip install –upgrade pip
  
  Use this command to upgrade the pip package manager to its newest version.

  If your pip is already in the latest version, this will come out: “Requirement already satisfied.”

• python –version
  
  Use this command if you want to check what version of Python you have.

• pip show pymongo
  
  Use this command to display information about your pymongo module, including its location.

  If you’re using Jupyter Notebook, use the command !pip show pymongo.

• pip install –upgrade pymongo
  
  Use this command to upgrade your pymongo module to its latest version.

  If it is already the latest version, this will come out: “Requirement already satisfied.”

  If you’re using Jupyter Notebook, use the command !pip install –upgrade pymongo.

Diagnostic checklist for “No module named ‘pymongo'”

• Verify pip install target. Run pip show pymongo — if not installed, run pip install pymongo.
• Check the active Python interpreter. which python (mac/Linux) or where python (Windows). Both pip and python must point to the same environment.
• Check virtual environment activation. If you use venv/conda, activate before installing: source .venv/bin/activate.
• Rule out uppercase/lowercase. Python imports are case-sensitive: import PyPDF2 not import pypdf2.
• Rule out the pip-vs-package-name mismatch. Some packages install under a different name than you import (e.g. pip install beautifulsoup4 → import bs4).

Installing pymongo

# Standard pip install
pip install pymongo

# In a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install pymongo

# With uv (faster alternative)
uv pip install pymongo

Common causes for “No module named ‘pymongo'”

• Python interpreter mismatch. Multiple Python installations can confuse pip. Verify with which python and which pip.
• Virtual environment not activated. If the venv isn’t activated, pip installs to your system Python instead.
• Notebook kernel mismatch. Jupyter uses a kernel that may differ from your terminal Python. Use %pip install pymongo inside the notebook.
• Import name differs from install name. pip install beautifulsoup4 → import bs4. Check the package’s PyPI page.
• Windows PATH issues. Ensure Python is on PATH; use python -m pip install to invoke pip via the correct Python.

Working code example

# Verify install worked
import pymongo
print(getattr(pymongo, '__version__', 'no version attribute'))

Best practices

• Always use a virtual environment. Avoids most module-not-found errors.
• Use pip freeze to lock versions. pip freeze > requirements.txt makes your setup reproducible.
• Consider uv or Poetry. Modern package managers with better dep resolution and reproducibility.

Conclusion

In conclusion, the error modulenotfounderror no module named pymongo can be easily solved by installing the pymongo module in your Python environment.

By following the guide above, there’s no doubt that you’ll be able to resolve this error quickly.

We hope you’ve learned a lot from this.

Thank you for reading!

Elijah Galero

Programmer & Technical Writer at PIES IT Solution

Elijah Galero is a programmer and writer at PIES IT Solution, author of 175+ tutorials at itsourcecode.com. Specializes in Python error debugging (AttributeError, TypeError, ModuleNotFoundError), Python programming tutorials, and Microsoft Excel how-to guides for BSIT students and productivity learners.

Expertise: Python · Python Errors · Python AttributeError · Python TypeError · ModuleNotFoundError · MS Excel · MS PowerPoint
 · View all posts by Elijah Galero →