HubSpot with ALTARA and your AI
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
/moverand/notasave 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.
- Open Customize > Connectors, find HubSpot and select Connect.
- Sign in to HubSpot, pick the account and permissions and select Connect app.
- In a chat, select + > Connectors and turn HubSpot on.
- Open Settings > Plugins (older versions say Apps), select HubSpot and Connect.
- Sign in, pick the account and permissions, then select Connect App.
- In a chat, type
@HubSpotor turn it on from +.
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):
claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 hubspot https://mcp.hubspot.comRun /mcp and sign in to HubSpot.
- Add the server:
codex mcp add hubspot --url https://mcp.hubspot.com --oauth-client-id YOUR_CLIENT_ID --oauth-client-secret "$HUBSPOT_CLIENT_SECRET"- Add the callback URL Codex prints to the connector's redirect URLs (Edit info).
- Run
codex mcp login hubspot.
- Add
http://localhost:8787/callbackas a redirect URL on the connector. - Add this to
~/.cursor/mcp.json, then open Customize, turn on hubspot and sign in:
{
"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
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.
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.
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.
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, read on November 20, 2026
- ALTARA help center: Integrations, read on November 20, 2026
- ALTARA help center: The agent, read on November 20, 2026
- ALTARA help center: Talking on WhatsApp, read on November 20, 2026
- HubSpot: Remote HubSpot MCP server, read on November 20, 2026
- HubSpot: Integrate AI tools with the HubSpot MCP server, read on November 20, 2026
- HubSpot Knowledge Base: Set up and use the HubSpot connector for Claude, read on November 20, 2026
- HubSpot Knowledge Base: Connect your HubSpot account to ChatGPT, read on November 20, 2026
- Claude Help Center: Get started with custom connectors using remote MCP, read on November 20, 2026
- Claude Code: Connect Claude Code to tools via MCP, read on November 20, 2026
- OpenAI: Codex Model Context Protocol, read on November 20, 2026
- Cursor: Model Context Protocol, read on November 20, 2026
- OpenAI Help Center: Connected apps in ChatGPT, read on November 20, 2026
Put it to work with ALTARA
-
weekly-pipeline-review/SKILL.mdSkill Plan the dayReview the pipeline every MondayA one-screen Monday plan from the CRM: slipped dates, deals with no next step, stale deals, concentration risk and five moves. Install → -
crm-hygiene-audit/SKILL.mdSkill Keep the CRM currentAudit and clean the CRMFinds duplicates, missing fields, stale deals, wrong stages and orphan contacts, and returns a fix list by risk. Writes nothing without approval. Install → -
meeting-brief/SKILL.mdSkill Brief every meetingBrief a meeting in five minutesA five-minute pre-meeting brief: the account, the people, dated news with sources, CRM history and three questions to ask. Public dataInstall → -
icp-from-won-deals/SKILL.mdSkill Research a marketDefine your ICP from deals you wonCompares closed-won and closed-lost deals criterion by criterion and returns an ICP with the deal counts behind every line. Public dataInstall → -
Runs in ALTARAPlaybook Plan the dayRun the Monday pipeline review in ALTARAText ALTARA for the week's plan, count the activities, find deals with no next step and fix them by chat. The review uses no credits. 20 minutes every MondayRun it →
-
Runs in ALTARAPlaybook Keep the CRM currentKeep the CRM current from your chats with ALTARAALTARA reads client chats and your call notes, prepares stage, note and next task, and saves only after your yes. Free, with undo. 5 minutes at the end of each dayRun it →
-
Runs in ALTARAPlaybook Brief every meetingBrief and follow up every meeting with ALTARABefore the call: CRM history and web research with sources. After it: a follow-up you send yourself, and the note and next task saved on your yes. 5 minutes before and 5 minutes after each meetingRun it →