Skip to main content
HubSpot’s local Developer MCP server connects your AI coding agent (such as Claude or Cursor) to HubSpot’s developer platform. It gives the agent access to HubSpot’s documentation, APIs, and project tools so it can build custom solutions on your behalf: writing the code, configuring the project, and deploying it to your account. This is the tool to reach for when you want to build something HubSpot doesn’t offer out of the box.

​
When to use the Developer MCP server

The Developer MCP server is the right choice when you want to:
  • Build an app card: display tailored information from external systems directly on contact, company, or deal records.
  • Create a custom workflow action: add logic to your workflows that goes beyond the built-in actions.
  • Add a UI extension: build an interactive interface that lives inside HubSpot, like a calculator, approval form, or data visualization.
  • Build a custom dashboard: pull together data from multiple sources into a single view that fits how your team works.

​
How it works

You work in a code editor with an AI coding agent. The Developer MCP server runs locally on your machine and gives the agent everything it needs:
  • HubSpot documentation: the agent can look up APIs, components, and platform features as it builds.
  • Project tools: the agent can create, validate, and deploy HubSpot projects directly from your editor.
  • Live feedback: when something goes wrong, the agent can read build errors and fix them without you needing to interpret log files.
You describe what you want, the agent builds it, and you review the result before deploying.

​
Standalone mode

If you’re working in a browser-based environment like GitHub Codespaces, Gitpod, or Lovable, run the HubSpot CLI in standalone mode. Standalone mode bypasses permissions issues that can arise in those environments and guarantees the agent executes tasks using the exact current version of the CLI. To enable standalone mode, pass the --standalone flag when running HubSpot CLI commands. See the CLI reference for details.
Last modified on September 9, 2026