View markdown

HubSpot tools

21 tools for HubSpot: how your CRM defines an MQL, Lead to MQL to SQL to deal by source, leads and deals, ad leads, segments, workflows, and report and dashboard details. Together with your ad accounts, they answer the question spreadsheets usually handle: what did this campaign cost per MQL?

Early access

The HubSpot connection isn't open to every workspace yet, and what it can do may change before it is.

Read tools are always available. The 8 write tools are off until you allow changes for HubSpot, and each one shows you a preview before anything changes.

Sample prompts
  • "What was our cost per MQL by campaign last month? How much spend couldn't be matched to a lead?"
  • "How do Lead, MQL and SQL compare by source against the previous month?"
  • "Which deals came from paid search this quarter?"
  • "Build a segment of customers and open opportunities that we can use as an exclusion."
  • "Draft a workflow that creates a task for sales when someone becomes an MQL."
  • "Copy our MQL report and put it on a new dashboard for the paid team."

Accounts & setup

ToolWhat it doesMode
hubspot_list_accountsThe HubSpot portals connected to this workspace.Read
hubspot_get_crm_setupLifecycle stages, deal pipelines, what the connection can do, and how complete your source data is.Read

CRM records

ToolWhat it doesMode
hubspot_search_contactsLeads by lifecycle stage, traffic source, created date, or segment. Contact details are masked by default.Read
hubspot_get_contact_journeyWhere one lead came from and where it went: sources, form conversions, lifecycle history, and related deals.Read
hubspot_search_dealsDeals by pipeline, stage, source, and date, with amounts and pipeline and stage names.Read

Funnel

ToolWhat it doesMode
hubspot_get_funnel_reportLead, MQL, SQL, and deals by traffic source, with stage-to-stage rates and change against a previous period.Read

Ad leads

ToolWhat it doesMode
hubspot_list_lead_formsWhich ad lead forms feed HubSpot, or an estimate by conversion event when HubSpot doesn't expose them, plus your other forms.Read
hubspot_get_lead_submissionsNew leads from a form with their answers. Contact details are masked by default.Read

Segments

ToolWhat it doesMode
hubspot_list_segmentsYour segments with how each one updates, its size, and whether HubSpot has finished processing it.Read
hubspot_get_segmentOne segment's conditions in plain language, a masked member sample, and the workflows that use it.Read
hubspot_create_segmentCreate a manual or condition-based segment, with a preview of who it would include.Write
hubspot_update_segmentRename a segment or change its conditions. Refused while an enabled workflow uses it.Write
hubspot_update_segment_membersAdd or remove records of a manual segment by record ID, with an exact undo.Write

Workflows

ToolWhat it doesMode
hubspot_list_workflowsYour workflows, what each one runs on, and whether it is on.Read
hubspot_get_workflowWhat one workflow does in plain language, who it keeps out, whether records can repeat it, and its risks.Read
hubspot_create_workflowCreate a workflow that is always off, with a plain preview and only safe steps. You turn it on in HubSpot.Write
hubspot_update_workflowEdit a workflow's steps, name, suppression or re-enrollment with a step-by-step preview and an undo. Everything else stays as it is.Write

Reports (beta)

ToolWhat it doesMode
hubspot_list_reportsYour HubSpot reports, who owns them, and which dashboards they are on. Report settings and numbers aren't readable.Read
hubspot_clone_reportCopy an existing report under a new name, private by default.Write
hubspot_update_report_detailsRename a report, change its description, owner or sharing, and add it to or remove it from dashboards, with an undo.Write
hubspot_create_dashboardBuild a new dashboard from reports you already have. If a report can't be added, the dashboard stays and you see which one.Write

Cost per MQL

Cost per MQL comes from a workspace tool, ads_get_crm_outcomes_by_campaign, listed under Workspace & automation. It joins HubSpot with spend from Google Ads, Meta Ads, and LinkedIn Ads. Bing and Reddit spend isn't included yet.

Each answer tells you how much of your data could be matched to a campaign. Spend with no leads and leads with no campaign are shown on their own, never spread across other campaigns. Tracking parameters on your ad links decide how much can be matched.

Numbers from the last few days can still move. Leads from ad platforms can take up to 2 hours to reach HubSpot, and new leads need time to reach the next stage.

What to expect

Contact details are masked by default. Names, emails, and phone numbers come back hidden unless you ask for them for a specific task.

Workflows are created off, and you turn them on in HubSpot. The AI can draft and edit a workflow, but it can't turn one on or off. Open it in HubSpot, check each step, and turn it on there. HubSpot asks whether to include people who already match.

Workflows can only use safe steps. Delays, setting a property, creating a task, adding to a manual segment, and branches. Emails, SMS, deleting contacts, subscription changes, custom code, and webhooks are refused. Rotating owners (rotate_owner) isn't available: add that step in HubSpot.

Reports can be copied and renamed, not rebuilt. The AI can copy a report, change its name, description, owner, or sharing, and build a dashboard from reports you already have. It can't create a report from scratch, change what a report measures, or read its numbers. For numbers, the AI uses the funnel and search tools above.

Workflows and reports rely on HubSpot beta features. HubSpot can change them, and a HubSpot admin has to opt in to the reporting beta. Workflows need a HubSpot Professional or Enterprise plan.

A permission added after you installed the app stays locked until an admin turns it on. If your HubSpot portal installed the Adsyncs app before a permission was added, that permission stays off and locked on HubSpot's consent screen. A HubSpot admin has to enable it under Connected Apps, Admin Settings, Data Permissions. Then Reconnect shows it. hubspot_update_segment_members needs crm.objects.contacts.write.

If HubSpot doesn't give a clear answer, the result says so. When HubSpot has a server error or times out during a create or an edit, the change may or may not have gone through. The result says the outcome is unknown and tells the AI to check before trying again, so you don't end up with two of the same thing.