https://github.com/python/mypy/pull/5691 and https://github.com/python/mypy/pull/5591 added support for importing type hints from namespace packages according to pep 561 but the documentation hasn't been updated to reflect it https://mypy.readthedocs.io/en/latest/installed_packages.html#using-pep-561-compatible-packages-with-mypy Specifically : > Note that mypy does not support some more advanced import features, such as zip imports, namespace packages, and custom import hooks. I suggest simply updating the docs to: > Note that mypy does not support some more advanced import features, such as zip imports, ~~namespace packages,~~ and custom import hooks.