HubSpot

HubSpot tells Rippit who the customer is on the commercial side: the deal, the lifecycle stage, the owner, the campaign that brought them in. Joined to conversation analysis, “these 40 tickets are about onboarding” becomes “these 40 tickets are about onboarding, and 12 of them are open deals with a close date this month.”

What the agent gets

CRM reads across standard and custom object types, by search, by SQL, or by ID.
Schema and property discovery, so the agent can find the right object type and internal property names without being told.
Conversation reads from HubSpot inboxes, including ticket transcripts and support case messages.
Marketing analytics: campaign attribution, content performance, and marketing email results.
CRM writes, if you enable the write tools: create and update records and their associations, add custom properties and pipelines, and build and edit segments.
Campaign, landing page, and marketing email writes, also behind the write tools.
AI search visibility (AEO): how often AI assistants mention and cite your brand, the prompts HubSpot tracks for you, and the recommendations it raises from them.

Setup

HubSpot does not let Rippit register itself as an OAuth client, so an admin creates an MCP auth app in HubSpot once and pastes its credentials into Rippit. Both steps are one-time and apply to the whole organization.

Create an MCP auth app in HubSpot

In your HubSpot account, create an MCP auth app following HubSpot’s own instructions. Add the redirect URI Rippit shows in the connect dialog, copied exactly rather than typed.The scopes you grant the app decide what the agent can reach. A scope the app does not have is a tool HubSpot will not offer.

Connect in Rippit

Paste the app’s client ID and client secret into Rippit, then authorize. HubSpot asks you to choose the account to connect and to confirm the permissions.

Identity and scope

The connection acts as the HubSpot user who authorized it, with the permissions that user has in that portal. A record the account cannot see is a record the agent cannot see. For an organization-wide connection, authorize with an account whose HubSpot permissions suit everyone who will use the agent, including scheduled runs.

Tools

The tools HubSpot offers depend on the scopes on your auth app and on the hubs in your portal, so your connection’s list may be shorter than the one below. Manage tools on the connection card shows exactly what your portal exposes.

Tool	Access	What it does
`search_crm_objects`	Read	Search CRM records by filters and criteria, with a total count for analysis
`query_crm_data`	Read	Query CRM data with SQL, for joins and aggregates search cannot express
`get_crm_objects`	Read	Fetch several records of one object type by ID in a single request
`discover_hubspot_schema`	Read	Find the data types available to the account, and their read and write access
`get_properties`	Read	Property definitions, including the valid options on enumeration properties
`search_properties`	Read	Keyword search across property definitions for an object type
`search_owners`	Read	Look up the owners who can be assigned to records
`get_user_details`	Read	The connected user’s identity, team, hubs, and permissions
`get_organization_details`	Read	Teams, job titles, seats, and account settings such as timezone and currency
`search_conversations`	Read	Search conversation threads, ticket transcripts, and support case messages
`get_conversation_channel_metadata`	Read	List inboxes, channels, and channel instances, to filter conversations by them
`read_campaign_data`	Read	Read campaigns, their assets, and their metrics
`get_campaign_attribution_reports`	Read	Attribution reporting across campaigns
`get_content_analytics_report`	Read	Performance for landing pages, website pages, and blog posts
`get_marketing_email_analytics`	Read	Results for marketing emails sent in a date range
`get_aeo_metrics`	Read	AI-search visibility for the portal: brand mentions, citations, competitor share of voice, and a breakdown by assistant
`search_intent_signals`	Read	Buyer-intent signals on companies and contacts: search signal records, list the portal’s signal types, or rank companies by signal count
`query_segments`	Read	Find segments by name, read a segment’s filter and exclusions, list its members, and look up the IDs segment filters take
`tool_guidance`	Read	Usage guidance HubSpot publishes for its own tools. Several tools require it before their first call
`manage_campaign_objects`	Write	Create and update campaigns, and manage their asset associations
`manage_landing_page`	Write	Create, edit, style, publish, and clone landing pages
`manage_marketing_email`	Write	Manage a marketing email’s settings and content
`manage_crm_objects`	Write	Create or update CRM records and their associations, up to ten per request
`manage_custom_properties`	Write	Add custom property schemas to a CRM object type
`manage_custom_pipelines`	Write	Add custom pipeline schemas to a CRM object type, or edit the default HubSpot pipeline
`manage_segment`	Write	Create static or filter-based segments, edit, delete, or restore them, change their exclusions, and add and remove records
`manage_aeo_prompts`	Write	Read an AI assistant’s answers to a tracked prompt, or start tracking new prompts
`manage_aeo_recommendations`	Write	List AI-search recommendations and run one, such as publishing a suggested blog post
`manage_onboarding`	Write	Walk a new portal through CRM onboarding steps
`submit_feedback`	Write	Send feedback about the HubSpot connector to HubSpot

The seventeen read tools are enabled by default. Every write tool asks HubSpot to confirm the change before it lands.

Getting Started

Connecting your Data

Using Rippit

Connecting to your AI Agent

Use cases

Reference

What the agent gets

Setup

Identity and scope

Tools

​What the agent gets

​Setup

​Identity and scope

​Tools

What the agent gets

Setup

Identity and scope

Tools