diff --git a/projectconf/advanced_scripting.rst b/projectconf/advanced_scripting.rst
index 49ab69fd92..07a7db5069 100644
--- a/projectconf/advanced_scripting.rst
+++ b/projectconf/advanced_scripting.rst
@@ -190,6 +190,14 @@ The ``extra_script.py`` file is located in the same directory as ``platformio.in
     # print(env.Dump())
     #
 
+    #
+    # (Optional) Do not run extra script when IDE fetches C/C++ project metadata
+    #
+    from SCons.Script import COMMAND_LINE_TARGETS
+
+    if "idedata" in COMMAND_LINE_TARGETS:
+        env.Exit(0)
+
     #
     # Change build flags in runtime
     #