Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Developer platforms - official HubSpot server

HubSpot Developer MCP server

Local MCP server bundled with the HubSpot CLI that gives coding agents HubSpot developer docs search plus tools to scaffold, validate, upload and deploy HubSpot projects, apps and CMS assets. Installed into supported clients with the hs mcp setup command. It runs locally from @hubspot/cli (npm); the notes below cover how it authenticates.

Last verified 15 tools5 sources

Install

Generic

Snippet
hs mcp setup

Tools

search-docs
Searches the official HubSpot developer documentation and returns the most relevant pages with URLs.
fetch-doc
Fetches the full content of a HubSpot developer documentation page from its URL.
search-knowledge-base
Searches the HubSpot Knowledge Base for how to use HubSpot products and features.
guided-walkthrough-cli
Provides step-by-step guided help for key HubSpot CLI commands.
get-feature-config-schema
Returns the JSON schema for a feature's -hsmeta.json configuration file.
create-project
Scaffolds a new HubSpot developer project.
add-feature-to-project
Adds a new feature to an existing HubSpot project.
validate-project
Validates a project's configuration files locally without uploading.
upload-project
Uploads (builds) a local project to HubSpot.
deploy-project
Deploys a previously uploaded build to the connected HubSpot account.
get-build-status
Retrieves build status and error messages for a HubSpot project.
get-build-logs
Retrieves full pipeline logs for a specific build.
auth-account
Authenticates a HubSpot account from an agent session using a Personal Access Key.
create-test-account
Creates a temporary HubSpot developer test account.
create-cms-module
Creates a new HubSpot CMS module (HubL or React).

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Generally available since February 19, 2026.
  • Requires HubSpot CLI 8.2.0 or higher (npm install -g @hubspot/cli); hs mcp setup interactively writes config for Claude Code, Codex CLI, Cursor, Gemini CLI, VS Code and Windsurf, so the docs give no per-client JSON.
  • Optional standalone mode runs via npx @hubspot/cli without a global install.
  • Authentication uses the CLI's HubSpot account auth / Personal Access Key.
  • Two tools (list-cms-serverless-functions, list-cms-remote-contents) are deprecated.
  • Separate from the remote HubSpot MCP server for CRM data.

FAQ

What does the HubSpot Developer MCP server do?

Local MCP server bundled with the HubSpot CLI that gives coding agents HubSpot developer docs search plus tools to scaffold, validate, upload and deploy HubSpot projects, apps and CMS assets. Installed into supported clients with the hs mcp setup command. The vendor documents 15 tools, including search-docs, fetch-doc, search-knowledge-base and guided-walkthrough-cli.

How do I add the HubSpot Developer MCP server to an MCP client?

Use hs mcp setup, copied from HubSpot's docs.

Does the HubSpot Developer MCP server need authentication?

It uses a scheme other than OAuth or an API key, such as the session of the app or instance it runs in; the notes on this page describe it. Transport: stdio. Status: GA, last checked October 17, 2026.

Sources

Last verified against 5 HubSpot pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.