Customize Breeze Agents With the Hubspot MCP Client

The Hubspot MCP client lets you connect Breeze agents directly to your CRM data so they can read, write, and update information in real time. By configuring this integration, you can safely expose specific CRM tools to agents, control what they can access, and guide how they interact with customer data.

This guide walks you through how to set up the MCP client, connect it to your account, and customize Breeze agents using your Hubspot configuration.

How the Hubspot MCP Client Works

The MCP client acts as a bridge between your CRM and your Breeze agents. It exposes a set of tools that agents can call, such as:

• Searching for records
• Creating or updating contacts, companies, or deals
• Retrieving CRM details inside a conversation

Each MCP client connection can be configured differently, so you can give certain agents access to one group of tools and other agents access to a different group.

Prerequisites for Using Hubspot With Breeze

Before you configure the MCP client, make sure you have:

• An active CRM account with API access
• Access to your API key or private app token
• Admin rights or equivalent permissions to manage integrations
• Access to Breeze and the ability to create or edit agents

If you are planning a larger implementation or multi-workspace rollout, consider reviewing broader CRM and RevOps best practices from partners like Consultevo.

Configure the Hubspot MCP Client

Configuration typically happens in your MCP or developer settings panel. The exact labels may differ slightly depending on your environment, but the steps remain similar.

1. Create a New MCP Client for Hubspot

1. Open your MCP or integration configuration area.
2. Choose the option to create a new MCP client.
3. Select the CRM provider as the source for this client.
4. Give the client a recognizable name, such as Hubspot CRM MCP.

Naming the client clearly helps you understand which Breeze agents rely on which CRM connection.

2. Enter Hubspot Authentication Details

Next, you must connect the MCP client to your account so it can authenticate safely.

1. Locate your private app token or OAuth credentials.
2. Paste the token or set the OAuth client ID and secret in the MCP client settings.
3. Specify environment variables if your platform requires them.
4. Save and test the connection to confirm a successful handshake.

If the test fails, verify:

• The token is active and has not expired.
• The scopes include CRM read and write permissions you plan to use.
• Your IP allowlist or firewall rules permit MCP traffic.

3. Select Which Hubspot Tools to Expose

The MCP client can expose multiple tools, but it is best practice to use the principle of least privilege. Only enable tools your Breeze agents actually need.

Common tool categories include:

• Contact search and retrieval
• Company and deal property lookups
• Record creation and updates
• Task or activity logging

In your MCP configuration:

1. Open the tools or capabilities section.
2. Toggle on the specific tools you want agents to call.
3. Optionally, restrict tools to certain pipelines, teams, or object types.
4. Save the configuration.

Later, you can duplicate this MCP client with a different tool set if another Breeze agent needs more limited access.

Connect the MCP Client to a Breeze Agent

Once the MCP client is set up, you can attach it to one or more Breeze agents so they can start working with your CRM data.

4. Attach the Hubspot MCP Client in the Agent Settings

1. Open Breeze and navigate to your list of agents.
2. Select the agent you want to connect to your CRM.
3. Go to the integrations or MCP section of the agent configuration.
4. Choose the MCP client you created earlier (for example, Hubspot CRM MCP).
5. Save the agent configuration.

The agent now has access to the tools you exposed, but you still need to provide clear instructions on how and when those tools should be used.

Customize Agent Prompts for Hubspot Usage

Prompt design is critical when an agent has access to live CRM data. You want to ensure that calls to your MCP tools are:

• Purposeful and relevant to the user’s request
• Compliant with your internal policies
• Efficient, to avoid unnecessary calls

5. Write System Instructions for CRM Behavior

Use the agent’s system prompt to define how it should use the CRM connection. Include details such as:

• Which tools are available via the MCP client
• Which objects (contacts, companies, deals) the agent should focus on
• Data that should never be created or updated automatically
• Conditions under which the agent must ask the user for confirmation

Example system guidelines:

• Search for existing contact records before creating a new one.
• Never modify billing details unless the user explicitly confirms the change.
• Log a note on the relevant record when summarizing a support interaction.

6. Add User-Facing Instructions for Data Collection

You can also adjust the agent’s instructions so it asks the right questions before issuing CRM changes. For example, prompt the agent to:

• Verify the user’s identity or email before accessing records.
• Confirm key fields like deal amount or close date.
• Summarize pending CRM updates for approval.

This reduces the risk of incorrect or incomplete data being written to your records.

Test and Validate Your Hubspot Integration

Before rolling the integration out widely, thoroughly test how Breeze agents work with your MCP client.

7. Run End-to-End Scenarios

1. Ask the agent to find a specific contact and verify that the correct record is returned.
2. Create a test contact or deal and confirm it appears in your CRM.
3. Update a non-critical property on a test record.
4. Check audit logs or history to ensure calls are logged as expected.

During testing, capture examples where the agent:

• Misinterprets the user’s intent.
• Makes unnecessary tool calls.
• Attempts changes you want to restrict.

Refine the system prompt and tool selection accordingly.

8. Apply Governance and Access Controls

To keep your data safe and compliant:

• Segment MCP clients by team or function, such as sales, support, or operations.
• Limit create or update tools to agents that truly need write access.
• Use CRM roles and permissions to back up MCP-level restrictions.
• Review logs regularly for unexpected agent behavior.

Maintain and Evolve Your Hubspot MCP Setup

As your processes change, you may need to adjust how Breeze agents interact with your CRM.

• Update system prompts when you introduce new pipelines or objects.
• Enable new tools in the MCP client as your use cases expand.
• Disable unused tools to reduce risk and complexity.
• Re-test after major CRM configuration changes.

For the most current technical steps, supported tools, and configuration options, refer to the official documentation at this Hubspot knowledge base article.

By carefully configuring the MCP client, aligning agent prompts with your policies, and validating behavior with real scenarios, you can turn your Breeze agents into secure and effective assistants that work seamlessly with your Hubspot data.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`