diff --git a/tools/pip-micropython b/tools/pip-micropython
index 0db699f0c0ea82a9da44939214c185548988306a..c7b23f1b6d3fa7a445435985b36c498919445407 100755
--- a/tools/pip-micropython
+++ b/tools/pip-micropython
@@ -5,6 +5,12 @@
 # complete library snapshot to be deployed on a device for baremetal
 # ports (if PIP_MICROPY_DEST environment var is set).
 #
+# Note: this tool is deprecated in favor of "upip" native MicroPython
+# package manager, which is bundled with MicroPython unix binary
+# as a frozen module and can be run as "micropython -u pip" or installed
+# from PyPI package "micropython-upip". This utility is left for
+# reference, regression testing, debugging, etc.
+#
 
 if [ "$1" != "install" ]; then
     echo "Only install command is supported currently"