Developer MCP server tools

The developer MCP server provides your AI assistant with tools for common HubSpot development tasks. Many tools execute HubSpot CLI commands on your behalf, so your assistant can scaffold projects, upload builds, check logs, and more without requiring you to run commands manually.

​

Documentation & guidance

​

guided-walkthrough-cli

Provides step-by-step guided help for key HubSpot CLI commands. Useful for onboarding developers or debugging CLI configuration issues. Returns CLI usage help text, available flags and options, and a suggested next command to run. Example prompt: “How do I authenticate with the HubSpot CLI?”

Show parameters

Parameter	Description
command	A specific command to provide guidance for. Can be one of: hs init, hs auth, hs project create, hs project upload

​

search-docs

Searches the official HubSpot developer documentation and returns the most relevant pages with URLs. Always follow with fetch-doc to get full content before writing code or answering technical questions. Returns up to 50 doc pages each with: title, URL, relevance score, and a content excerpt. Example prompt: “Search the docs for information about building app cards”

Show parameters

Parameter	Description
docsSearchQuery	Text search query.

​

fetch-doc

Fetches the full authoritative content of a HubSpot developer documentation page from its URL. Use immediately after search-docs and before writing code or answering technical questions. Returns the full markdown content of the page including prose, OpenAPI YAML specs, and code examples Example prompt: “Search the docs for information about building app cards, then fetch the full contents of the most relevant reference doc”

Show parameters

Parameter	Description
docUrl	Full URL of the HubSpot docs page to retrieve

​

Developer projects

​

get-feature-config-schema

Returns the JSON schema for a feature’s -hsmeta.json configuration file. Always call before editing any -hsmeta.json to understand valid values and constraints. Requires platform version 2025.2 or higher. The schema includes all properties, required fields, types, enums, patterns, and nested definitions. Example prompt: “Get the schema for app card configuration”

Show parameters

Parameter	Description
platformVersion	The platform version to retrieve the schema for (e.g. 2025.2).
featureType	The feature type to retrieve the schema for. Must match the type field in the -hsmeta.json file (e.g. card).

​

get-build-status

Retrieves build status and error messages for a HubSpot project. Omit buildId to see the most recent builds; provide buildId for detailed error info on that build. Returns build records with status, buildErrorMessage, subbuild failures, and timestamps. Example prompt: “Check the status of my latest build”

Show parameters

Parameter	Description
absoluteProjectPath	Absolute path to the project directory.
buildId	The build ID to retrieve status for.
limit	Number of recent builds to return when no buildId is provided. Defaults to 3.

​

get-build-logs

Retrieves full pipeline logs for a specific build. Best used after get-build-status to investigate warnings or failures that need more detail. Returns filtered log lines from the full build pipeline for the specified build ID. Example prompt: “Show me the build logs for build ID 123 and help me fix any errors”

Show parameters

Parameter	Description
absoluteProjectPath	Absolute path to the project directory.
buildId	The build ID to retrieve logs for. Use get-build-status to find build IDs.
logLevel	Log level filter. Can be one of: ERROR, WARN, INFO, ALL. Defaults to ALL.

​

create-project

Scaffolds a new HubSpot developer project. Supports empty or app-based templates with optional features. Auth type and distribution cannot be changed after first upload. Returns a scaffolded project directory with hsproject.json and all selected feature boilerplate files. Example prompt: “Create a new project with one app card and a settings page”

Show parameters

Parameter	Description
destination	Relative path where the project will be created.
projectBase	The project template to use. Can be one of: empty, app.
name	The name of the project.
auth	Authentication type. Can be one of: static, oauth.
distribution	Distribution type. Can be one of: marketplace, private.
features	Array of features to include. Can be one of: card, settings, app-function, webhooks, workflow-action, workflow-action-tool, app-object, app-event, scim, page.

​

add-feature-to-project

Adds a new feature to an existing HubSpot project. Only compatible with projects using platform version 2025.2 or later. Returns new feature scaffold files and updated configuration added to the existing project directory. Example prompt: “Add a webhook to my existing project”

Show parameters

Parameter	Description
absoluteProjectPath	Absolute path to the project directory.
addApp	Whether to scaffold an app alongside the feature.
features	Array of features to add.
auth	Authentication type for the feature.
distribution	Distribution type for the feature.

​

validate-project

Validates a project’s configuration files locally without uploading anything. Useful for catching configuration errors early. Not required before uploading. Returns either a confirmation the project is valid, or a list of configuration errors and warnings. Example prompt: “Validate my project and show me any issues”

Show parameters

Parameter	Description
absoluteProjectPath	Absolute path to the project directory.

​

upload-project

Uploads (builds) a local project to HubSpot, creating it remotely if it does not exist yet. Only invoke when the user explicitly requests it, as this action is potentially destructive. Returns an upload confirmation with the build ID and initial build status. Example prompt: “Validate my project, then upload it to HubSpot”

Show parameters

Parameter	Description
absoluteProjectPath	Absolute path to the project directory.
uploadMessage	A one-sentence description of the changes being uploaded.
profile	Account profile to upload to. Must be explicitly specified by the user if provided.

​

deploy-project

Deploys a previously uploaded build to the connected HubSpot account. Only invoke when the user explicitly requests a deployment. Returns deployment status, deployment ID, and confirmation that the build is live. Example prompt: “Deploy build number 42 of my project”

Show parameters

Parameter	Description
absoluteProjectPath	Absolute path to the project directory.
buildNumber	The build number to deploy. Defaults to the most recent build.

​

Account & apps

​

create-test-account

Creates a temporary HubSpot developer test account for local development and QA. Each hub defaults to Enterprise tier if not specified. Can use a JSON configuration file or inline parameters. Returns a confirmation with the new test account ID and access credentials. Example prompt: “Create a test account with Professional tier for all hubs”

Show parameters

Parameter	Description
name	The name of the test account.
description	A description of the test account.
marketingLevel	Marketing Hub tier. Can be one of: FREE, STARTER, PROFESSIONAL, ENTERPRISE.
salesLevel	Sales Hub tier. Can be one of: FREE, STARTER, PROFESSIONAL, ENTERPRISE.
serviceLevel	Service Hub tier. Can be one of: FREE, STARTER, PROFESSIONAL, ENTERPRISE.
opsLevel	Operations Hub tier. Can be one of: FREE, STARTER, PROFESSIONAL, ENTERPRISE.
contentLevel	Content Hub tier. Can be one of: FREE, STARTER, PROFESSIONAL, ENTERPRISE.
configPath	Path to a JSON configuration file for the test account.

​

get-api-usage-patterns-by-app-id

Returns API usage analytics for a specific app showing which endpoint patterns are called and across how many accounts. Date range cannot exceed 3 months. Returns a patternSummaries object with per-pattern stats including portalPercentage and numOfPortals. Example prompt: “What is the usage pattern summary for my app?”

Show parameters

Parameter	Description
appId	The numeric app ID (e.g. 3003909).
startDate	Start of the date range in YYYY-MM-DD format.
endDate	End of the date range in YYYY-MM-DD format. The date range cannot exceed 3 months.

​

get-applications-info

Lists all HubSpot applications registered in the connected account. Run this first to discover app IDs before calling any app-specific tools. Returns an array of objects, each with an appId (number) and appName (string). Example prompt: “Show me all my apps and their IDs”

​

CMS tools

​

create-cms-template

Creates a new HubSpot CMS template using hs create template. Supports page, email, partial, global partial, blog listing/post, search, and section template types. Returns a scaffolded .html template file at the destination path. Example prompt: “Create a new page template called ‘Product Landing‘“

Show parameters

Parameter	Description
userSuppliedName	The name of the template.
templateType	The type of template to create. Can be one of: page-template, email-template, partial, global-partial, blog-listing-template, blog-post-template, search-template, section
dest	Destination path where the template will be created.

​

create-cms-module

Creates a new HubSpot CMS module (HubL or React). Supports content type targeting, global flag, and new-content availability. Returns a scaffolded module directory with meta.json, fields.json, and module.html or module.jsx. Example prompt: “Help me add a React module to my existing project”

Show parameters

Parameter	Description
userSuppliedName	The name of the module.
moduleLabel	Display label for the module (required for non-interactive use).
reactType	Whether to create a React module instead of HubL.
contentTypes	Comma-separated list of content types the module targets. Can be one of: ANY, LANDING_PAGE, SITE_PAGE, BLOG_POST, EMAIL.
availableForNewContent	Whether the module is available for new content.
global	Whether the module is a global module.
dest	Destination path where the module will be created.

​

create-cms-function

Creates a new CMS serverless function using hs create function. Supports all HTTP methods. For non-interactive use, provide all three of functionsFolder, filename, and endpointPath. Returns a scaffolded .functions/ directory and serverless.json configuration at the destination path. Example prompt: “Generate a serverless function with a POST endpoint at /api/submit-form”

Show parameters

Parameter	Description
functionsFolder	The folder to create the function in (required for non-interactive use).
filename	The filename for the serverless function (required for non-interactive use).
endpointPath	The endpoint path for the function (required for non-interactive use).
endpointMethod	HTTP method for the endpoint. Can be one of: DELETE, GET, PATCH, POST, PUT. Defaults to GET.
dest	Destination path where the function will be created.

​

get-cms-serverless-function-logs

Retrieves production logs for a deployed CMS serverless function. Use after list-cms-serverless-functions to obtain the correct endpoint path. Returns log entries for the specified function with timestamps, invocation data, and output. Example prompt: “Get the logs for my deployed serverless function at /api/contacts”

Show parameters

Parameter	Description
endpoint	The function path (e.g. my-function).
account	Account ID or name.
latest	Return only the most recent log entry.
compact	Return a compact log format.
limit	Maximum number of log entries to return.

​

list-cms-serverless-functions (deprecated)

Deprecated. Use the hs cms function list CLI command instead. Lists all serverless functions deployed to a HubSpot account. Returns a table or JSON of deployed functions with routes, HTTP methods, secrets, and timestamps.

Show parameters

Parameter	Description
account	Account ID or name.
json	Return raw JSON instead of a formatted table.

​

list-cms-remote-contents (deprecated)

Deprecated. Use the hs cms list CLI command instead. Lists the contents of a remote HubSpot CMS directory. Returns a list of files and folders in the specified CMS directory.

Show parameters

Parameter	Description
account	Account ID or name from the CLI configuration.
path	Remote CMS directory path. Defaults to the root directory.