Last modified: August 22, 2025
When developing HubSpot apps or CMS web content in your IDE, you can install the HubSpot development MCP server via the CLI. The HubSpot development MCP server runs locally and provides your AI assistant with additional instructions and context for streamlining app and CMS development tasks, including:
  • Learning how to use the HubSpot CLI
  • Searching documentation
  • Creating a project
  • Adding app features
  • Adding content assets (themes, templates, and modules)
  • Validating local project files
  • Uploading a project
  • Deploying a project

​
Prerequisites

  • Join the developer MCP server public beta.
  • Ensure you’re running version 7.6.0 or higher of the HubSpot CLI. You can check your version by running hs --version, and you can install the latest version by running npm install -g @hubspot/cli@latest.

​
Set up the server

To get started with HubSpot’s developer MCP server, run hs mcp setup in your terminal. 
hs mcp setup
You’ll then be prompted to select which client you’d like to add the CLI MCP server to. Supported clients include Cursor, Claude Code, VS Code, and Windsurf. Once the setup is complete, restart your client to apply the changes.

​
Usage

With the developer MCP server set up, you can prompt your client’s AI assistant to perform the HubSpot development tasks below.
For the best results, it’s recommended to use Anthropic’s Claude Sonnet 4 or newer. While other models are supported, Claude Sonnet models deliver the most consistent and reliable results.
  • HubSpot CLI walkthrough: receive guidance on how to use the HubSpot CLI, including common commands for building, testing, and managing your apps.
  • Search documentation: find answers to common questions using the publicly available HubSpot developer platform documentation.
  • Create a new project: generate a new HubSpot project with specified features and configuration.
  • Add a feature or CMS asset to an existing project: add app features (e.g., app cards, workflow actions, and webhooks) or CMS content assets (e.g., themes, templates, and modules) to a project.
  • Project validation: validate your local project configuration and identify potential issues prior to uploading and deploying your app.
  • Upload a project: upload your project to HubSpot (by default, automatically deploys after successful build).
  • Deploy a project: deploy the most recent successful build of a project (for projects with auto-deploy turned off).
For example, you can use natural language prompts like:
  • "Walk me through how to create a test account from the CLI"
  • "Create a new project with app cards, a custom workflow action, and settings"
  • "Help me add a React theme to my existing project"
  • "Validate my project, then upload it to HubSpot"