> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/settings/third-party-apps/hubspot-mcp.md).

# HubSpot MCP

Sign in to HubSpot to connect its MCP server, so your agent can search contacts and update deals.

HubSpot MCP is HubSpot's own MCP server. You connect it once in Third party apps. After that, your AI agent can use the tools that HubSpot publishes, such as searching contacts by name, email or phone, creating contacts from a chat and moving a deal to another stage.

***

### Prerequisites

* A BotPenguin account with access to the More menu.
* A HubSpot account that can approve access for apps.
* A pop-up blocker that allows the HubSpot sign-in window.
* About 10 minutes. You must finish the HubSpot approval page within 10 minutes after you start.

***

### Key Definitions

| Term           | Meaning                                                                                 |
| -------------- | --------------------------------------------------------------------------------------- |
| MCP            | Model Context Protocol. A standard way for an AI agent to use the tools of another app. |
| MCP server URL | The address of the MCP server. BotPenguin fills it in for you.                          |
| Tool           | An action that the app publishes. The app decides which tools exist.                    |
| Connection     | One saved account that your agents can use.                                             |

***

### Steps

1. Click **More** in the left menu, then click Third party apps.

![Click More, then Third party apps](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/UeDLNMlAp3p7M3uumTgq/images/hubspot-mcp-step-1.png)

2. Type HubSpot MCP in the search box, then open the **HubSpot MCP** card. Do not open HubSpot, which is the CRM app.

![Search for HubSpot MCP and open its card](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/Lc5OghFInY3louBddq9Z/images/hubspot-mcp-step-2.png)

3. On the Connected accounts tab, click **Add connection**. The Connect HubSpot MCP panel opens.

![Click Add connection on the HubSpot MCP page](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/Y8ZwxLMJ22LsofiCQtoN/images/hubspot-mcp-step-3.png)

4. In the panel, type a Connection name if you want one. Click **Continue with HubSpot MCP** to start the HubSpot sign-in (OAuth) in another window. Sign in and approve access.

![Click Continue with HubSpot MCP to start the sign-in](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/nLWzSPaTKKKDVCUwnhum/images/hubspot-mcp-step-4.png)

5. When the sign-in is finished, the panel shows Connected as with your HubSpot email. Click **Save Configuration**.

![Click Save Configuration after you sign in](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/5P751WvNImE4wLp3EfIE/images/hubspot-mcp-step-5.png)

6. Check the Connected accounts tab. Your HubSpot MCP account appears in the list with an Active status.

![The Connected accounts tab shows one Active account](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/12GDojMM0I0noSbg6x9z/images/hubspot-mcp-step-6.png)

***

### Common Errors

<details>

<summary>I do not see Third party apps in the More menu</summary>

Click More in the left menu and look under Connections for Third party apps. If it is still missing, your role may not allow it. Ask your account owner.

</details>

<details>

<summary>I see two HubSpot cards</summary>

HubSpot is the CRM app. HubSpot MCP is a separate app for MCP tools. Open the card named HubSpot MCP to follow this guide.

</details>

<details>

<summary>Save Configuration is grey</summary>

You can save only after you sign in. Click Continue with HubSpot MCP first, then wait for Connected as to show.

</details>

<details>

<summary>The HubSpot sign-in window did not open</summary>

Your browser may have blocked the pop-up. Allow pop-ups for BotPenguin, then click Continue with HubSpot MCP again.

</details>

<details>

<summary>The sign-in window closed and HubSpot MCP is not connected</summary>

You may have cancelled the approval, waited more than 10 minutes, or HubSpot refused the request. Click Continue with HubSpot MCP again and finish the approval. The approval page must be completed within 10 minutes.

</details>

<details>

<summary>The tools in my agent changed</summary>

HubSpot publishes the tools, not BotPenguin. The list can change when HubSpot updates its server. Sync the tools again in your agent and select the ones you need.

</details>

<details>

<summary>Can I connect more than one HubSpot MCP account?</summary>

Yes. Click Add connection again. Give each one a clear Connection name so you can pick the right one when you build an agent.

</details>

<details>

<summary>My agent says the connection needs to be reconnected</summary>

Access was removed in HubSpot, or HubSpot no longer accepts the saved sign-in, for example after a password reset. Add the connection again and sign in again.

</details>

***

### Support

Still not working? Write to us at <support@botpenguin.com>. We will reach out to you within 24 hours.
