Yes. The HubSpot CLI is free and open-source under Apache 2.0. Install with `npm install -g @hubspot/cli`. It works with all HubSpot CMS tiers including the free CMS tools. You pay for HubSpot platform subscriptions, not the CLI.

Can AI agents use HubSpot CLI?

Yes for CMS development workflows. After initial authentication (`hs init` requires browser), your agent uploads themes (`hs upload`), watches for changes (`hs watch`), fetches remote files (`hs fetch`), and scaffolds new assets (`hs create`). Account switching supports multi-portal management. CRM operations (contacts, deals, workflows) require the HubSpot API directly.

What can the HubSpot CLI do?

CMS development: build and deploy themes, templates, modules, and serverless functions. Local development with `hs watch` for automatic syncing. Scaffolding with `hs create` for new projects. Multi-account management for sandbox and production portals. The CLI covers the developer workflow — design, build, deploy. For CRM automation (contacts, deals, emails), use the HubSpot API.

What is the difference between HubSpot CLI and the HubSpot API?

Different scope. The CLI handles CMS development: themes, templates, modules, local dev, and deployments. The API handles CRM operations: contacts, deals, companies, workflows, emails, and automation. Your agent uses the CLI for building and deploying CMS assets, and the API for integrating with HubSpot's CRM data. Both can be used together.

HubSpot CLI

183 stars

official open-source Cross-platform Actively maintained

The official HubSpot CLI. Build CMS themes, develop serverless functions, manage local dev environments, and deploy to HubSpot from the command line.

Part of the HubSpot CLI tools for AI agents

What your agent can do

You build HubSpot CMS themes in the Design Manager. Click through the file tree, edit in the browser editor, preview, publish. Repeat for every template, module, and partial. Your agent runs `hs watch src/themes/my-theme my-theme` and edits locally with your real editor. Every save syncs to HubSpot automatically. Real editor, real version control, real development workflow.The HubSpot CLI bridges local development with HubSpot's cloud CMS. `hs upload` pushes your local theme files to the Design Manager. `hs fetch` pulls them down. `hs watch` keeps them in sync. Your agent develops themes, modules, and serverless functions locally, version-controls them in git, and deploys them to HubSpot from the command line.`hs create` scaffolds new HubSpot assets from templates. `hs create website-theme my-theme` generates a complete theme structure with boilerplate templates, modules, and configuration. Your agent bootstraps new projects without navigating the HubSpot dashboard or manually creating file structures.For teams managing multiple HubSpot portals, the CLI supports named authentication contexts. Your agent switches between sandbox and production portals by name, deploying to the right environment without credential juggling. Combined with `hs upload --account=production`, deployments target specific portals explicitly.The $78 CPC on "hubspot cli" is the highest of any tool in the directory. The developers searching for this are building on HubSpot's $2B+ platform — high-intent commercial traffic looking for better development workflows.

Limitations

CMS and developer tooling focused — does not cover CRM operations (contacts, deals, workflows) which require the HubSpot API directly. Low GitHub stars (183) because most HubSpot development happens through the API, not the CLI. No MCP server. Some commands require interactive browser authentication on first use. Limited to HubSpot's CMS platform.

Key Commands

hs init Initialize a HubSpot project with authentication configuration

hs upload Upload local files to the HubSpot Design Manager

hs watch Watch for local file changes and sync to HubSpot automatically

hs fetch Download files from HubSpot to your local filesystem

hs create Scaffold a new HubSpot asset from templates

GitHub Stats

repo HubSpot/hubspot-cli

stars 183

language TypeScript

license Apache-2.0

last commit Mar 20, 2026

Links

Official documentation developers.hubspot.com/docs/platform/hubspot-cli GitHub repository github.com/HubSpot/hubspot-cli CMS developer guide developers.hubspot.com/docs/cms/guides

FAQ

Is HubSpot CLI free?: Yes. The HubSpot CLI is free and open-source under Apache 2.0. Install with `npm install -g @hubspot/cli`. It works with all HubSpot CMS tiers including the free CMS tools. You pay for HubSpot platform subscriptions, not the CLI.
Can AI agents use HubSpot CLI?: Yes for CMS development workflows. After initial authentication (`hs init` requires browser), your agent uploads themes (`hs upload`), watches for changes (`hs watch`), fetches remote files (`hs fetch`), and scaffolds new assets (`hs create`). Account switching supports multi-portal management. CRM operations (contacts, deals, workflows) require the HubSpot API directly.
What can the HubSpot CLI do?: CMS development: build and deploy themes, templates, modules, and serverless functions. Local development with `hs watch` for automatic syncing. Scaffolding with `hs create` for new projects. Multi-account management for sandbox and production portals. The CLI covers the developer workflow — design, build, deploy. For CRM automation (contacts, deals, emails), use the HubSpot API.
What is the difference between HubSpot CLI and the HubSpot API?: Different scope. The CLI handles CMS development: themes, templates, modules, local dev, and deployments. The API handles CRM operations: contacts, deals, companies, workflows, emails, and automation. Your agent uses the CLI for building and deploying CMS assets, and the API for integrating with HubSpot's CRM data. Both can be used together.