# Connect HubSpot to your AI

> ALTARA reads one HubSpot pipeline, read-only, and sends each change with a link to the deal. Your own AI reads the same records through HubSpot's MCP.

Canonical: https://www.altaratech.com/store/connections/hubspot
Shelf: Connection · Job: Keep the CRM current
Official MCP server: yes · URL: https://mcp.hubspot.com · Auth: OAuth with your HubSpot login (PKCE required)
With ALTARA: Reads (rolling out). ALTARA reads one HubSpot pipeline and proposes each change for you to make in HubSpot; it saves nothing. Rolling out with the first companies.

ALTARA reads one pipeline in your company's HubSpot, read-only, and is being rolled out with the first companies. It answers from your deals and proposes each change, and you make the change in HubSpot. HubSpot's own MCP server, at `https://mcp.hubspot.com`, lets your own AI read the same records, so ALTARA and your assistant work from one pipeline.

## How ALTARA works with HubSpot

In a company on HubSpot, ALTARA reads one pipeline: deals, stages, owners, companies, contacts, notes, tasks, calls, meetings and the emails logged in HubSpot, when the access allows. It saves nothing.

- **Your deals** are the ones whose HubSpot owner has your name. If ALTARA cannot tell which owner is you, it asks.
- **Changes:** it prepares them and asks you to confirm, as it does everywhere. After your yes, it sends the exact change, deal by deal, with a link to the deal in HubSpot, so you make it there. Commands such as `/mover` and `/nota` save nothing.
- **Short lists:** it shows about 10 deals at a time, highest value first, and offers the next ones.
- **In the console,** the **Accounts** area has a button that opens the pipeline in HubSpot.
- **Reading the pipeline costs no credits.**

The ALTARA team connects your company's HubSpot with read-only access. If your company uses HubSpot, talk to the team when you start.

Messages to send ALTARA:

- "Which of my deals are in Proposal?"
- "Tell me about Pinecrest Engineering before the meeting."
- "Move Pinecrest Engineering to Negotiation." (You get the change and the deal link to make it in HubSpot.)

## Connect it to your AI

HubSpot's server works on every HubSpot plan; the Claude connector needs a paid Claude plan (Pro, Max, Team or Enterprise). Super Admins and users with App Marketplace Access connect right away; everyone else waits for a Super Admin to approve the connector. Your AI sees only what your HubSpot user sees. It can view, create and update, but not delete, and HubSpot's API limits apply. For Claude Code, Codex and Cursor, create an MCP connector in HubSpot (**Development > MCP Connectors > Create MCP connector**) to get a client ID and secret.

### Claude

1. Open **Customize > Connectors**, find **HubSpot** and select **Connect**.
2. Sign in to HubSpot, pick the account and permissions and select **Connect app**.
3. In a chat, select **+ > Connectors** and turn HubSpot on.

### ChatGPT

1. Open **Settings > Plugins** (older versions say **Apps**), select **HubSpot** and **Connect**.
2. Sign in, pick the account and permissions, then select **Connect App**.
3. In a chat, type `@HubSpot` or turn it on from **+**.

### Claude Code

If you sign in with your claude.ai account, the HubSpot connector from Claude shows up in `/mcp`. To use your own MCP connector, add `http://localhost:8080/callback` as its redirect URL, then run this (it prompts for the secret):

```bash
claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 hubspot https://mcp.hubspot.com
```

Run `/mcp` and sign in to HubSpot.

### Codex

1. Add the server:

```bash
codex mcp add hubspot --url https://mcp.hubspot.com --oauth-client-id YOUR_CLIENT_ID --oauth-client-secret "$HUBSPOT_CLIENT_SECRET"
```

2. Add the callback URL Codex prints to the connector's redirect URLs (**Edit info**).
3. Run `codex mcp login hubspot`.

### Cursor

1. Add `http://localhost:8787/callback` as a redirect URL on the connector.
2. Add this to `~/.cursor/mcp.json`, then open **Customize**, turn on hubspot and sign in:

```json
{
  "mcpServers": {
    "hubspot": {
      "url": "https://mcp.hubspot.com",
      "auth": {
        "CLIENT_ID": "${env:HUBSPOT_CLIENT_ID}",
        "CLIENT_SECRET": "${env:HUBSPOT_CLIENT_SECRET}"
      }
    }
  }
}
```

## Start read-only

Grant the CRM read permissions first and add edit permissions later. HubSpot recommends setting write tools to **Needs Approval** in Claude and ChatGPT, so every create or update waits for your yes. Leave Sensitive Data off unless you need it. To revoke access, open the connector in Claude's settings or ChatGPT's **Settings > Plugins** and select **Disconnect**.

## Prompts to try

```text
In HubSpot, list the notes, tasks, calls and meetings logged on my open deals in the last 7 days, grouped by deal, with the stage and the next open task. Read only.
```

```text
Before my call with [company], read its HubSpot record: open deals, the last five emails, meetings and notes, and open tasks. Give me a five-line brief and three questions to ask. Read only.
```

```text
Here is the change ALTARA sent me: [paste the change and the deal link]. Open that deal in HubSpot, show me the field as it is and as it will be, and wait for my yes before saving.
```

```text
In HubSpot, list my open deals that close this quarter and have no open task. Show deal name, stage, amount, close date and last activity date, sorted by amount.
```

## If it does not work

- **"Connector needs approval":** a Super Admin approves it, or grants you App Marketplace Access.
- **New permissions missing:** after a Super Admin changes them, each user disconnects and connects again.
- **OAuth fails in Claude Code, Codex or Cursor:** the redirect URL must match one on the connector exactly, and the client must use PKCE.
- **Stage rules skipped in ChatGPT:** HubSpot says custom validation rules, including stage validations, are not applied there. Check the record after an update.
- **ALTARA does not find your deals:** it reads one pipeline and matches you by the HubSpot owner name. Tell it which owner is you.

## Sources

- [ALTARA help center: Pipeline and CRM](https://docs.altaratech.com/en/docs/agent/pipeline-and-crm), read on 2026-11-20
- [ALTARA help center: Integrations](https://docs.altaratech.com/en/docs/console/integrations), read on 2026-11-20
- [ALTARA help center: The agent](https://docs.altaratech.com/en/docs/agent), read on 2026-11-20
- [ALTARA help center: Talking on WhatsApp](https://docs.altaratech.com/en/docs/agent/whatsapp), read on 2026-11-20
- [HubSpot: Remote HubSpot MCP server](https://developers.hubspot.com/docs/build-with-ai/remote-mcp-server), read on 2026-11-20
- [HubSpot: 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), read on 2026-11-20
- [HubSpot Knowledge Base: Set up and use the HubSpot connector for Claude](https://knowledge.hubspot.com/integrations/set-up-and-use-the-hubspot-connector-for-claude), read on 2026-11-20
- [HubSpot Knowledge Base: Connect your HubSpot account to ChatGPT](https://knowledge.hubspot.com/integrations/connect-your-hubspot-account-to-chatgpt), read on 2026-11-20
- [Claude Help Center: Get started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp), read on 2026-11-20
- [Claude Code: Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp), read on 2026-11-20
- [OpenAI: Codex Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp?surface=cli), read on 2026-11-20
- [Cursor: Model Context Protocol](https://cursor.com/docs/mcp), read on 2026-11-20
- [OpenAI Help Center: Connected apps in ChatGPT](https://help.openai.com/en/articles/11487775-connected-apps-in-chatgpt), read on 2026-11-20
