HubSpot MCP Policy

GET STARTED

Download this policy scaffold and add your rules. Intercept enforces them on every tool call before it reaches HubSpot.

terminal

# Download policy scaffold


curl -o hubspot.yaml https://raw.githubusercontent.com/policylayer/intercept/main/policies/hubspot.yaml

# Run with Intercept


intercept --policy hubspot.yaml -- npx -y @@hubspot/mcp-server

Server documentation: https://github.com/HubSpot/mcp-server

READ TOOLS

14

hubspot-get-user-details Authenticate and get user info, hub details, and scopes

hubspot-list-objects Retrieve a paginated list of CRM records for a specified object type

hubspot-search-objects Search CRM records using complex criteria and property-based filtering

hubspot-batch-read-objects Retrieve multiple CRM records by their IDs in a single batch

hubspot-get-schemas Retrieve available custom object schemas with definitions

hubspot-list-properties Retrieve the complete catalog of properties for any CRM object type

hubspot-get-property Retrieve detailed information about a specific property

hubspot-list-associations Retrieve existing relationships between records

hubspot-get-association-definitions Retrieve valid association types between object types

hubspot-get-engagement Retrieve engagement details by ID

hubspot-list-workflows Retrieve a paginated list of workflows

hubspot-get-workflow Retrieve detailed information about a specific workflow

hubspot-get-link Generate HubSpot UI URLs to directly access records

hubspot-generate-feedback-link Generate a feedback link for reporting issues

WRITE TOOLS

7

hubspot-batch-create-objects Create multiple CRM records in a single API call

hubspot-batch-update-objects Update multiple CRM records with new property values

hubspot-create-property Create new custom properties for CRM object types

hubspot-update-property Update settings for existing custom properties

hubspot-batch-create-associations Establish relationships between CRM records

hubspot-create-engagement Create engagements (Notes or Tasks) associated with records

hubspot-update-engagement Update an existing engagement with new information

POLICY YAML

This scaffold lists every tool with empty rules. Add conditions — rate limits, argument validation, deny rules — then deploy with Intercept.

hubspot.yaml

version: "1"
description: "Policy for @hubspot/mcp-server"
default: "allow"
tools:
    hubspot-get-user-details:
        rules: []
    hubspot-list-objects:
        rules: []
    hubspot-search-objects:
        rules: []
    hubspot-batch-read-objects:
        rules: []
    hubspot-get-schemas:
        rules: []
    hubspot-list-properties:
        rules: []
    hubspot-get-property:
        rules: []
    hubspot-list-associations:
        rules: []
    hubspot-get-association-definitions:
        rules: []
    hubspot-get-engagement:
        rules: []
    hubspot-list-workflows:
        rules: []
    hubspot-get-workflow:
        rules: []
    hubspot-get-link:
        rules: []
    hubspot-generate-feedback-link:
        rules: []
    hubspot-batch-create-objects:
        rules: []
    hubspot-batch-update-objects:
        rules: []
    hubspot-create-property:
        rules: []
    hubspot-update-property:
        rules: []
    hubspot-batch-create-associations:
        rules: []
    hubspot-create-engagement:
        rules: []
    hubspot-update-engagement:
        rules: []

RELATED POLICIES

FREQUENTLY ASKED QUESTIONS

What tools does the HubSpot MCP server expose?

The HubSpot MCP Server exposes 21 tools across 2 categories: Read, Write. Each tool can be individually controlled with Intercept policies.

How do I enforce policies on HubSpot?

Download the policy scaffold, add rules (rate limits, argument validation, deny rules), then run Intercept as a proxy in front of the HubSpot MCP server. Every tool call is evaluated against your YAML policy before execution.

Is the HubSpot policy free to use?

Yes. All Intercept policies are open source under the Apache 2.0 licence. Download, modify, and deploy without restrictions.

ENFORCE POLICIES ON HUBSPOT

Open source. One binary. Zero dependencies.

VIEW ON GITHUB Browse all policies →