Install the HubSpot CLI — HubSpot docs

Source: https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/install-the-cli (reached via https://developers.hubspot.com/docs/cms/developer-reference/local-development-cli) Last modified: May 26, 2026 (commands overview page) Source quality: primary (official HubSpot documentation)

Key facts

• The HubSpot CLI connects your local environment to HubSpot, giving you local copies of your app assets so you can use version control, your favorite text editor, and web development technologies on the HubSpot developer platform.
• Per the commands overview: the CLI lets you "build and deploy apps to HubSpot, develop on the HubSpot CMS with version control, integrate with your favorite text editor, and more."
• Requires Node.js version 20 or higher.
• Install globally with npm install -g @hubspot/cli (or locally with npm install @hubspot/cli; Yarn supported with yarn prefix).
• Authentication: run hs account auth, which prompts you to generate a Personal Access Key in your account, then paste it into the terminal to save configuration.
• Multi-directory support: link an authenticated account to a directory with hs account link; config profiles supported.
• Scope of CLI is dev/app assets and CMS development (themes, modules, serverless, apps) — not CRM record data management.