Skip to main content
By the end of this guide, you’ll have the HubSpot CLI and Developer MCP server installed and connected to your AI coding agent. From there, you describe what you want to build and your agent handles the implementation.

​
Prerequisites

Before you start, you’ll need:
  • A HubSpot account (create a free HubSpot account if you don’t have one).
  • An AI coding agent (this is what will do the building for you). If you don’t have one yet, it’s recommended to download Claude Code or Cursor and install it before continuing.

​
Connect your tools to HubSpot

1

Open your AI coding agent

Open the chat interface of your AI coding agent (e.g., Claude Code or Cursor).
2

Paste the setup prompt

Copy the prompt below below and paste it into the chat window. Your agent will read the HubSpot documentation and walk you through setup one step at a time, asking for your approval before proceeding.

I'm installing the HubSpot CLI and the Developer MCP server using this guide. Ask me which AI coding agent I plan to use (such as Claude Code or Cursor) if I haven't mentioned it. When we get to the HubSpot authentication part, walk me through how to do it, and encourage me to not paste my key into the chat (it should be handled automatically after creating my personal access key in HubSpot). Anytime you need me to do something in the HubSpot UI please provide instructions. Once all set up, direct me to the example prompts page for ideas on getting started.

Open in Cursor
3

Connect your HubSpot account

At some point, your agent will ask you to open a program called Terminal (Mac and Linux) or Command Prompt/PowerShell (Windows) to run a command. This command connects your local environment to your HubSpot account, which enables you and your agent to upload custom built features to HubSpot.Once you run the command, a browser window will open and ask you to sign in to HubSpot. Sign in and follow the on-screen instructions, then your terminal window will update to confirm that your account is connected.
Please note: never give any login or authentication credentials directly to an AI tool (i.e., don’t copy-paste them into the chat). The browser sign-in is the only place your credentials should go.
4

Let your agent finish setup

After you sign in, your agent handles the rest automatically. You’ll know setup is complete when your agent confirms that the HubSpot MCP server is connected, at which point it will typically offer suggestions on what to build next.

​
Build

With those installed, you can ask your agent to start building. If you’re not sure where to start, you can:
  • Check out the example prompts page, which provides prompts for creating various custom app features.
  • Chat with Breeze Assistant in your HubSpot account to learn about your data and currently available features.
  • Copy the project setup prompt below into your agent’s chat window for a more guided setup.

Sets up a new HubSpot project tailored to how you work. The agent will ask about your HubSpot experience, coding background, and goals, then scaffold the project with agent context files so that every future session starts with the right context for you.

This prompt is intentionally long, but you only paste it once. It starts with a short conversation with your agent about your familiarity with HubSpot and general coding, then uses your answers to tailor an AGENTS.md file and specs/ folder directly into your project.

See more example prompts

Ready-to-use prompts for building app cards, app pages, website modules, and more.

​
Next steps

The best practices guides in this section are designed to be read in order:
  1. Foundations
  2. Working with your agent
  3. Managing your project
  4. Scaling up
There are also a few other tools in this section that complement the Developer MCP server as your work evolves:
  • Breeze Assistant: for exploring what’s possible and getting quick answers without leaving HubSpot.
  • Agent CLI: for managing CRM records in bulk, cleaning up data, or generating test records while you build.
  • Remote HubSpot MCP server: for connecting an external AI tool to HubSpot, or building your own AI-powered HubSpot integration.
If something isn’t working, post a question in the HubSpot developer community.
Last modified on September 9, 2026