diff --git a/docs/getting-started/flashing-firmware/flashing-esp32.mdx b/docs/getting-started/flashing-firmware/flashing-esp32.mdx
index e75a8275..69d9c092 100644
--- a/docs/getting-started/flashing-firmware/flashing-esp32.mdx
+++ b/docs/getting-started/flashing-firmware/flashing-esp32.mdx
@@ -152,7 +152,13 @@ values={[
 {label: 'Windows', value: 'windows'},
 ]}>
 <TabItem value="linux"></TabItem>
-<TabItem value="macos"></TabItem>
+<TabItem value="macos">
+
+:::important
+On MacOS, you may need to explicitly declare esptool as a .py script. Use `esptool.py chip_id`.
+:::
+
+</TabItem>
 <TabItem value="windows">
 
 :::important