How to fix npm ERR! gyp ERR! stack Error: `xcode-select --install` to install the command line tools in npm

What this error means

This error occurs when npm attempts to build a native Node.js module but can't find the necessary compilation tools on your macOS system. Native modules (written in C/C++) need a compiler and related build tools to install. On macOS, these are provided by the Xcode Command Line Tools package, which includes clang, make, and other essential development utilities. The error message helpfully tells you exactly what command to run to fix it.

Typical symptoms

• npm install fails with gyp ERR! messages
• Error specifically mentions xcode-select --install
• Happens when installing packages with native dependencies
• Occurs on fresh macOS installations or after major OS updates
• Affects packages like node-gyp, bcrypt, sharp, sqlite3, and canvas

Common causes

1. Command Line Tools have never been installed on this Mac
2. macOS was upgraded and Command Line Tools were removed
3. Xcode was uninstalled, removing the Command Line Tools
4. Command Line Tools installation is corrupted or incomplete
5. xcode-select is pointing to an invalid or missing path

How to fix "npm ERR! gyp ERR! stack Error: `xcode-select --install` to install the command line tools"

xcode-select --install

xcode-select -p

/Library/Developer/CommandLineTools

gcc --version

npm install

sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install

Advanced notes

sudo xcode-select --switch /Library/Developer/CommandLineTools

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

touch /tmp/.com.apple.dt.CommandLineTools.installondemand.in-progress
softwareupdate -i -a
rm /tmp/.com.apple.dt.CommandLineTools.installondemand.in-progress

Frequently asked questions

What does "npm ERR! gyp ERR! stack Error: `xcode-select --install` to install the" mean?

js module but can't find the necessary compilation tools on your macOS system. Native modules (written in C/C++) need a compiler and related build tools to install. On macOS, these are provided by the Xcode Command Line Tools package, which includes clang, make, and other essential development utilities.

How do I fix "npm ERR! gyp ERR! stack Error: `xcode-select --install` to install the"?

This error indicates that macOS Command Line Tools are missing, which are required for compiling native Node.js modules. Install them using xcode-select to resolve the issue.

What causes "npm ERR! gyp ERR! stack Error: `xcode-select --install` to install the"?

Command Line Tools have never been installed on this Mac macOS was upgraded and Command Line Tools were removed Xcode was uninstalled, removing the Command Line Tools

Is the "npm ERR! gyp ERR! stack Error: `xcode-select --install` to install the" error serious?

It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Related errors

• npm WARN optional SKIPPING OPTIONAL DEPENDENCY: [email protected] (node_modules/fsevents): unsupported platform

  How to fix "SKIPPING OPTIONAL DEPENDENCY: fsevents unsupported platform" in npm

  LOW

• npm ERR! code ENEEDAUTH npm ERR! Not logged in

  How to fix "npm ERR! code ENEEDAUTH Not logged in" error

  HIGH

• npm ERR! gyp ERR! stack Error: Agreeing to the Xcode license requires admin privileges

  How to fix "npm ERR! gyp ERR! Agreeing to the Xcode license requires admin privileges"

  MEDIUM

• npm ERR! code E401 npm ERR! Incorrect or missing password

  How to fix npm E401 'Incorrect or missing password' error

  HIGH

• npm ERR! code EAI_AGAIN

  How to fix "EAI_AGAIN" in npm

  MEDIUM

• npm ERR! code EPERM npm ERR! This operation requires administrator privileges

  How to fix "EPERM: This operation requires administrator privileges" in npm

  MEDIUM

Official resources & further reading

• 📚npm Official Documentation
• 📖
  Apple Developer Tools(Official Docs)
• 💬
  Stack Overflow: macOS(Stack Overflow)
• 📚
  node-gyp macOS Wiki