Use HubSpot with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Search, create, and manage HubSpot contacts, companies, notes, tasks, and associations through natural conversation.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 10 capabilities
The complete HubSpot capability set.
These are the exact actions your AI can choose when you ask it to work with HubSpot.
01-04
4 capabilities in this set.
Part of 10 available through HubSpot.
- 01
Hs create company
The name is required. Providing the website domain (e.g., "acme.com") helps HubSpot auto-enrich the company with public data. Industry should match HubSpot industry categories. Returns the created company with its new HubSpot ID. Create a new company record in HubSpot CRM with name, domain, industry, and phone
- 02
Hs create contact
Email is the primary deduplication key. if a contact with the same email already exists, the API will return an error. Provide first name, last name, phone, company name, and lifecycle stage to fully populate the record. Returns the created contact with its new HubSpot ID. Create a new contact in HubSpot CRM with email as the unique identifier, plus name, phone, and company
- 03
Hs create note
The body supports HTML. Notes appear in the timeline of associated records. essential for keeping CRM activity history. Provide contact, company, or deal IDs to link the note. Use to log meeting notes, call summaries, or internal context. Create an engagement note in HubSpot attached to a contact, company, or deal for activity logging
- 04
Hs create task
Tasks appear in the tasks queue and can be assigned to owners. Set priority to HIGH, MEDIUM, or LOW. Due date should be ISO format. Associate with a contact by providing their ID. Use when the user wants to schedule follow-ups, create reminders, or assign action items. Create a follow-up task in HubSpot with subject, due date, priority, and optional contact association
05-07
3 capabilities in this set.
Part of 10 available through HubSpot.
- 05
Hs get associations
For example: objectType="companies", objectId="123", toObjectType="contacts" returns all contacts associated with company 123. Common patterns: company→contacts, contact→deals, deal→contacts, contact→tickets. Use when the user asks "which contacts are at this company?" or "what deals does this contact have?" Get associations between HubSpot CRM objects. e.g., find all contacts linked to a company, or deals linked to a contact
- 06
Hs get contact
Returns full contact data including name, email, phone, company, lifecycle stage, lead status, last activity date, and all custom properties. Use after searching contacts to drill into a specific person for full details. Get the complete details of a specific HubSpot contact by their record ID
- 07
Hs search companies
Returns company name, website domain, industry, annual revenue, employee count, and assigned owner. Use when the user wants to find a specific company, look up organizational details, or check company-level CRM data. Search HubSpot CRM companies by name, domain, or industry to find organizations
08-10
3 capabilities in this set.
Part of 10 available through HubSpot.
- 08
Hs search contacts
Returns first name, last name, email, phone, associated company, lifecycle stage (subscriber/lead/MQL/SQL/opportunity/customer/evangelist), and assigned HubSpot owner. Use when the user wants to find a specific person, check contact details, verify lifecycle stage, or look up who is at a particular company. Search HubSpot CRM contacts by name, email, phone, or company to find people in your database
- 09
Hs update company
Only specified fields are updated. Use when the user wants to update company details, correct industry classification, or change the domain. Update properties of an existing HubSpot company by their record ID
- 10
Hs update contact
Only the fields you provide will be updated. other fields remain unchanged. Use when the user wants to correct contact info, update a phone number, change lifecycle stage, or reassign a contact. Update properties of an existing HubSpot contact by their record ID
Observed, not estimated
968ms average. Fast in production.
HubSpot is checked daily against the live service.
- Fastest day
- 792ms
- Slowest day
- 1144ms
- 14-day trend
- Slowing+36%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of HubSpot, so you can see the experience inside your AI.
It does not authenticate your account with HubSpot. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
HubSpot Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_p7q2aT1o0ZP4L6ZJ7lqaGSxd56Oi6UwNAQ5xGN84/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — HubSpot capabilities are ready to use.
{
"mcpServers": {
"hubspot-crm-mcp": {
"url": "https://edge.vinkius.com/vk_preview_p7q2aT1o0ZP4L6ZJ7lqaGSxd56Oi6UwNAQ5xGN84/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions HubSpot owners ask.
- 01
What HubSpot data can I access?
Contacts, Companies, Deals, Tickets, Notes, Owners, and Pipelines. All data respects your HubSpot permissions.
- 02
Can I create and update records?
Yes! Create contacts, deals, tickets, and notes. All through natural conversation.
- 03
How does authentication work?
Uses a HubSpot Private App token (Bearer). Create a Private App in Settings > Integrations > Private Apps, copy the token, and paste it.
Explore
More in Industry Titans
Uniqode AI Connector
Create trackable QR codes with custom branding, dynamic content updates, and scan analytics for marketing and
ViewVolcengine RTC AI Connector
Bring ByteDance's internal RTC Engine to your AI workflow. Administrate audio/video calls, manage servers, and
ViewMarkdown Task Extractor AI Connector
Instantly scan any local folder of Markdown notes (Obsidian, Notion, Logseq) and aggregate every scattered '-
ViewVerbit AI Connector
Automate professional transcription and captioning via Verbit — upload media, track job progress, and retrieve
View
Suggestions
Restful Booker AI Connector
Manage hotel bookings via the Restful Booker API—create, retrieve, update, and delete reservations directly fr
ViewLiveKit Real-Time Rooms AI Connector
Manage LiveKit voice and video rooms — create sessions, control participants, mute tracks, and broadcast data
ViewBusiness Logic Gatekeeper AI Connector
Ensures code changes adhere to business invariants using regex-based validation.
ViewAssertible AI Connector
Automate API testing and monitoring via Assertible — trigger deployments, run service tests, and sync specific
View
