HubSpot MCP for AI. Manage your entire CRM through conversation.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
HubSpot MCP gives your AI client access to a complete CRM, letting you manage contacts, companies, and deals using natural conversation.
Instead of clicking through dashboards, you can ask your agent to find specific accounts, update deal stages, or create new leads—all without ever leaving your workflow.
It's like having the entire HubSpot database available as a chat tool.
What your AI can do
Link crm objects
Creates a formal association between two records, such as connecting a Contact to their Company.
Create contact
Adds a brand new contact record to the system.
Remove contact
Permanently deletes an existing contact record from the system.
Search across contacts, companies, and deals using specific filters and metadata.
Create new contacts from scratch or update details on existing company accounts.
Manually link related CRM entities, such as connecting a specific contact to the company they work for.
View all available fields and properties across contacts, companies, or deals to see what information is tracked.
List which users within your organization own specific records or manage the overall user roster.
Ask an AI about this
Waiting for input…
HubSpot MCP: 12 Tools for CRM Data Management
These twelve tools let you interact with every major element of your HubSpot data—from creating contacts to inspecting object schemas and associating records.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using HubSpot on VinkiusLink Crm Objects
Creates a formal association between two records, such as connecting a Contact to their Company.
Create Contact
Adds a brand new contact record to the system.
Remove Contact
Permanently deletes an existing contact record from the system.
Get Company Info
Retrieves full details about a specific company account.
Get Contact Details
Fetches all information related to an individual contact.
Get Deal Details
Gets the status and details for a specific sales deal.
List Companies
Provides an overview and list of all company accounts in the CRM.
List Contacts
Retrieves a general listing of contacts within your HubSpot environment.
List Deals
Lists all active sales deals, showing their current stage and assigned value.
List Hubspot Users
Retrieves a list of all users who own records or are managed accounts in HubSpot.
Get Object Schema
Lists all available fields (properties) for any given object type, like contacts or...
Search Contacts
Finds specific contacts using advanced, filter-based queries.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with HubSpot, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HubSpot. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 12 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
The Pain of Context Switching
Think about your typical Tuesday afternoon. You start in Slack to chat with the team, then realize you need to check if that lead is associated with an existing company record. Next, you open HubSpot, find the contact, and then maybe switch over again to look at the deal pipeline status. It's a constant cycle of copy-pasting IDs and clicking between dashboards.
With this MCP, all that context switching disappears. Your agent handles the complexity behind the scenes. You simply ask: 'What is John Smith’s latest deal status?' and you get the answer, pulling data from the contact record, associated company history, and current deal pipeline—all in one response.
Get Deal Details
You no longer have to hunt through multiple tabs just to find a deal's full financials. You can ask the agent for get_deal_details, and it pulls the amount, the current stage, the assigned owner, and the expected close date—all in one conversational burst.
The data is always fresh, instantly accessible, and context-aware. This isn't just viewing a record; this is treating your entire sales pipeline as an API endpoint.
What your AI can actually do with this
Need to manage customer records but hate switching tabs? This MCP connects your AI client directly into your core CRM data, letting you handle sales and marketing operations entirely through conversation. You can ask your agent to pull up company details, search for contacts using complex filters, or even create a brand new lead record.
It doesn't just read data; it executes actions—you can link records together (like connecting a contact to a specific deal) or update the stage of an entire pipeline. This level of direct action is what makes Vinkius the essential platform for connecting your AI agents to enterprise systems. You use this MCP when you need conversational access to complex, structured data that normally requires multiple clicks and exports.
019dd106-b007-7388-bac8-95c604f3ae74 Here's how it actually works
The bottom line is that it gives conversational access to every major piece of structured data in your HubSpot instance.
Subscribe to this MCP and enter your HubSpot Private App Access Token.
Connect it to your preferred AI client (Cursor, Claude, etc.).
Ask your agent a natural language question like, 'Find all contacts who deal with Enterprise SaaS.' The agent then executes the necessary calls to retrieve and format the data for you.
Who is this actually for?
Anyone whose job involves juggling multiple systems to manage customer relationships. This MCP helps the RevOps specialist who spends hours exporting CSVs, the Sales rep tired of context switching between their CRM and chat tools, or the Marketing manager who needs instant audience data.
Auditing data quality by inspecting schemas or managing record associations across different object types.
Quickly retrieving contact details, updating deal stages, and finding associated companies without opening the main CRM dashboard.
Segmenting audiences by searching contacts using specific criteria or auditing available properties for new campaign fields.
What Changes When You Connect
Stop switching tabs. Instead of logging into the HubSpot UI to check deal progress, you just ask your agent for 'all deals in negotiation' and get a real-time list.
Build out data quality instantly. Need to know what fields are available? Use the schema discovery tool to map out exactly what information is tracked on contacts or companies before starting a campaign.
Automate record relationships. You don't have to manually click through screens; you can tell your agent to 'link this contact to that company,' and it handles the association instantly.
Deep search capabilities. Forget simple keyword searches. Use advanced tools to filter contacts by job title, industry, or specific property values for highly targeted lists.
Full visibility across records. Get detailed breakdowns of any deal's financial status using get_deal_details, showing amounts, stages, and assignment history in one go.
See it in action
The Quarterly Review
A RevOps specialist needs to audit data integrity. Instead of running 10 separate reports, they ask the agent for a list of companies and then request details on all associated contacts that haven't been updated in six months. The agent pulls the company info, lists the contacts, and flags those needing attention.
The Cold Start Lead
A Marketing Manager identifies a target industry via external data. They use advanced search to find all contacts with that industry email domain, then immediately use create_contact to log them as leads and link the record back to the originating company.
The Deal Closure Update
A Sales Rep just had a call. Instead of logging into HubSpot and manually updating fields, they tell their agent: 'Update the deal for Acme Corp; move it to Proposal stage and add $50k in value.' The MCP handles the update instantly.
The Missing Link
A user finds a contact record but realizes they don't know which company that person belongs to. They ask the agent, 'What is this contact associated with?' and the tool returns the correct Company ID, allowing immediate association.
The honest tradeoffs
Assuming listing equals searching
Asking the MCP to 'list all contacts in California.' This might return thousands of records, making it useless for finding a specific subset.
You need to use search_contacts. That tool accepts advanced filters and returns only the exact set of data you're looking for, like contacts where state equals CA AND industry is Tech.
Manually recreating records
Copying contact names and company IDs into a spreadsheet and trying to re-upload them later.
Use create_contact or get_company_info. The MCP handles the internal ID structure, ensuring that when you build records, they are correctly associated with your existing data.
Ignoring record dependencies
Trying to update a deal value without first confirming which company owns the contact linked to it.
Always check associations. Before updating anything, use link_crm_objects or list_contacts to confirm that all necessary records are correctly tied together.
When It Fits, When It Doesn't
Use this MCP if your workflow requires constant data interaction—if you need to read and write contacts, deals, or company metadata without leaving the chat interface. It's built for people who treat their CRM like a conversational API. Don't use it if you just need to view a static report or download a simple list of names; in those cases, native HubSpot reporting is faster. If your job requires knowing exactly what fields are available on an object before writing code, get_object_schema is the first tool you call. But remember: this MCP handles data, not email sending or task scheduling—for that, you'll need a dedicated workflow automation platform.
Questions you might have
How do I find specific contacts using the search_contacts tool? +
You use advanced filtering syntax, much like HubSpot's native filters. You can specify multiple criteria in one query, such as finding all contacts where 'Industry is Tech' and 'Last Name contains Smith'.
Can I update a deal stage using the get_deal_details tool? +
While get_deal_details lets you read the status, you use other tools to change it. You must reference the specific deal ID when asking your agent to move the record.
What is the difference between list_contacts and search_contacts? +
list_contacts gives you a broad overview of contacts, but search_contacts lets you narrow down that massive list using specific criteria. Use search for accuracy; use list when you just need to see who's there.
Do I have to manually link records after using this MCP? +
No. You tell the agent what needs linking, and it executes the link_crm_objects tool for you, ensuring all your associated data is clean and connected.
How do I find out all the available properties when using get_object_schema? +
It lists every possible property for any object type. Use this tool first to map out the schema; you'll know exactly what fields exist before trying to read or write data, preventing API errors.
What information does list_hubspot_users provide regarding my team's access? +
It shows all HubSpot users and who owns the records. This is useful for auditing ownership rights and identifying which accounts are authorized to perform actions, like creating new contacts or viewing sensitive deals.
If I use the remove_contact tool, what happens to associated data? +
It deletes the contact record entirely. Be careful, this action is irreversible and will break any associations with other CRM objects like companies or active deals that rely on it for context.
How do I ensure a new contact is properly linked to an existing company using link_crm_objects? +
You must pass the unique IDs for both the contact and the company records. This tool formally creates the association, ensuring your AI client recognizes them as related objects in the CRM view.
Can I search for contacts using specific filters? +
Yes. The search_contacts tool accepts a JSON array of HubSpot filters. Example: [{"propertyName":"email","operator":"CONTAINS_TOKEN","value":"@company.com"}]. This uses HubSpot's native search API to find contacts matching property values, date ranges, or engagement criteria. Use get_object_schema with 'contacts' to discover all searchable properties.
Can I link contacts to companies and deals? +
Yes. Use link_crm_objects with the source object type and ID, target object type and ID, and the association type name. Example: link a contact to a company with fromType='contacts', fromId='123', toType='companies', toId='456', associationType='contact_to_company'. This creates bidirectional CRM relationships.
What type of HubSpot credential do I need? +
You need a Private App Access Token from your HubSpot account. This is different from OAuth tokens — it provides direct API access scoped to the permissions you select when creating the Private App. The token is sent as a Bearer token in the Authorization header against api.hubapi.com.
Powerful workflows you can unlock today
Get Product Intel Before Sales Demos via MCP
Your AE is about to demo the dashboard feature for 30 minutes to a prospect who already used it 47 times in the trial , meanwhile the prospect only opened the API docs once and clearly needs help there
Identify Unprofitable Agency Clients Using MCP
Your biggest client generates 28% of revenue but consumes 45% of your team's time , and you will not know they are your least profitable account until you compare project hours against deal value, which nobody does because the data is in 3 different tools
MCP Recipe for Agency Prospect Research
Your sales rep spends 40 minutes researching every prospect on LinkedIn before a call , and still walks in without knowing the company just raised funding, their tech stack changed, or they are actively looking for an agency
MCP Recipe for Agency SEO Dashboards
Your SEO manager manually exports Google Analytics data for 8 clients every Monday morning , and by the time the last client report is done, the first client's data is already a week old
MCP Recipe for Automated Lead Qualification
A prospect fills out your agency's inquiry form at 11pm , and gets a generic 'thanks, we will be in touch' email while your competitor who responds in 5 minutes wins the deal because speed kills in agency sales
MCP Recipe for Email Campaign Attribution
Your email campaign got a 24% open rate and 3.8% click rate , which tells the client nothing about how many people actually visited the site, filled out a form, or became a paying customer from that email
We've already built the connector for HubSpot. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 12 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.