> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spojit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect the HubSpot MCP server

> Connect HubSpot's remote MCP server to Spojit: create an MCP connector (auth app) in HubSpot, add Spojit's redirect URL, and sign in with OAuth and PKCE.

HubSpot hosts a remote MCP server with read and write access to your CRM: contacts, companies, deals, tickets, activities, and marketing content such as landing pages, blog posts, and campaigns. Connect it to Spojit to create deals from form fills, log activity from other systems, or enrich contacts with AI.

<Note>
  Spojit connects to this server through a [custom MCP server](/connectors/remote-mcp-servers/custom) connection, so you add it with **Add custom server** rather than from the connector catalog. HubSpot maintains it and decides which tools it offers; see [HubSpot's remote MCP server documentation](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server) for the current list.
</Note>

## Before you start

Before connecting, create an MCP connector in HubSpot to get a client ID and secret for Spojit.

<Steps>
  <Step title="Copy Spojit's redirect URI">
    In Spojit, go to **Connections**, click **Add custom server**, and choose **OAuth 2.0**. Copy the **Redirect URI** shown in the form (for example `https://miraxa.spojit.com/api/connectors/oauth/callback`).
  </Step>

  <Step title="Create an MCP connector in HubSpot">
    In HubSpot, go to **Development > MCP Connectors** and click **Create MCP connector**. Enter a **Name** such as `Spojit`, paste Spojit's redirect URI as the **Redirect URL**, and create it.
  </Step>

  <Step title="Copy the credentials">
    Open the connector's details page and copy the **Client ID** and **Client secret**.
  </Step>
</Steps>

## Server URL

```
https://mcp.hubspot.com
```

## Connect in Spojit

<Steps>
  <Step title="Add a custom server">
    In **Add custom server**, enter a **Name** such as `HubSpot` and paste the **Server URL**.
  </Step>

  <Step title="Choose Auto authentication">
    Choose **Auto** and click **Save & connect**. Because HubSpot needs your own app, the **OAuth 2.0** form opens with the authorization and token URLs already filled in.
  </Step>

  <Step title="Enter your connector's credentials">
    Paste the **Client ID** and **Client Secret**, leave **Use PKCE (S256)** on (HubSpot requires it), and click **Save & connect**.
  </Step>

  <Step title="Approve access in HubSpot">
    HubSpot opens its consent page. Sign in and approve. Spojit marks the connection **Connected** and refreshes the token automatically.
  </Step>
</Steps>

If the form does not prefill, choose **OAuth 2.0** and enter **Authorization URL** `https://mcp.hubspot.com/oauth/authorize/user` and **Token URL** `https://mcp.hubspot.com/oauth/v3/token`. Leave **Scopes** empty: HubSpot grants access based on the signed-in user's permissions.

## Use it in a workflow

Add a **Connector** node, pick your HubSpot server under **Custom Servers**, and choose **Agent Mode** or **Direct Mode**. See [Use a custom server in a workflow](/connectors/remote-mcp-servers/custom#use-a-custom-server-in-a-workflow).

## Things to know

* **Permissions follow the user.** Tools can only reach records the HubSpot user who approved the connection can see.
* **Sensitive Data blocks some tools.** If your account has Sensitive Data turned on, activity and conversation data is not available through the MCP server.
* **Some tools need a subscription tier**, for example Marketing Hub Professional for certain marketing tools.

## Troubleshooting

<AccordionGroup>
  <Accordion title="HubSpot reports a redirect URL mismatch">
    The connector's **Redirect URL** must match Spojit's **Redirect URI** exactly.
  </Accordion>

  <Accordion title="Activity or conversation tools return nothing">
    Sensitive Data is turned on for the account, which blocks that data from the MCP server.
  </Accordion>
</AccordionGroup>

## Learn more

* [Integrate AI tools with the HubSpot MCP server](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)
* [HubSpot MCP Server](https://developers.hubspot.com/ai-tools/mcp)

<Snippet file="start-free.mdx" />