# HubSpot MCP for AI Agents AI Agent Connect > HubSpot MCP connects your CRM to your AI agent, letting you manage contacts, companies, and deals without leaving your chat window. It handles everything from listing users and pipelines to searching for specific leads and linking records together. It's built for teams who want to stop tab-switching and start getting work done through simple commands. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_GfjmHsHrTu0vKqaaAyy6fJlETQ9ZLIUX67F7Zw0D/ai-agent-connect - **Tags:** contact-management, deal-pipelines, lead-nurturing, crm-integration, company-records, sales-operations ## Description This HubSpot MCP lets you manage your entire CRM through natural conversation with your AI agent. You can stop jumping between tabs to update records or hunt for lead information because your agent can do the heavy lifting for you. If you need to find a specific lead, create a new contact, or link a person to a company, you just tell your agent what to do. It handles the data entry and record association while you stay focused on your actual work. You can also audit your data by pulling property schemas or checking your sales pipelines to see where deals are stalling. When you connect this through the Vinkius catalog, you turn your CRM into a dynamic data source that your agent can actually interact with. Instead of manual copy-pasting from emails into contact fields, your agent handles the updates. You get a conversational interface for your sales and marketing data, making it easier to keep your records clean and your pipeline moving. ## Tools ### list_companies Get a full list of companies in your CRM. This helps you see your entire corporate database at a glance. ### link_crm_objects Create associations between contacts, companies, and deals. Use this to keep your records connected and organized. ### create_contact Add a new contact record to your database. This saves you from manual data entry in the HubSpot dashboard. ### remove_contact Delete a specific contact from your records. Use this to keep your database clean of old or duplicate leads. ### get_company_info Pull specific details for a single company. This is useful for getting a quick summary of a corporate account. ### get_contact_details Fetch full information for a specific contact. Use this to see everything you know about a lead in one place. ### get_deal_details View the specifics of a single deal. This gives you the stage, amount, and owner for any active opportunity. ### list_contacts View a list of all contacts in your CRM. This lets you browse your entire lead list quickly. ### list_deals See all deals across your sales pipelines. Use this to get a high-level view of your current sales activity. ### list_hubspot_users Identify all users and record owners in your account. This helps you see who is responsible for which data. ### get_object_schema View all available fields for a specific object type. This is perfect for auditing your CRM properties. ### search_contacts Find specific contacts using HubSpot filter syntax. This lets you query your database for very specific lead types. ## Prompt Examples **Prompt:** ``` Show me all deals in the pipeline and tell me which one is the highest value. ``` **Response:** ``` ### Active Deals | Deal Name | Value | Stage | Owner | | :--- | :--- | :--- | :--- | | Enterprise SaaS Migration | **$285,000** | Negotiation | Sarah Chen | | Cloud Security Audit | $120,000 | Proposal | Mike Torres | | Q4 Expansion | $45,000 | Qualified | Lisa Park | **Summary:** * **Total Pipeline Value:** $892,000 * **Top Deal:** Enterprise SaaS Migration ($285k) is currently in the Negotiation stage. Would you like to see the contact details for the top deal? ``` **Prompt:** ``` Search for all contacts with @enterprise.com emails and create a new contact for the CEO. ``` **Response:** ``` ### Search Results for '@enterprise.com' * James Rodriguez (VP Sales) * Ana Müller (Director Marketing) * Chen Wei (Head of Engineering) * Sarah Johnson (HR Manager) **Action Taken:** ✅ **New Contact Created:** * **Name:** David Williams * **Email:** ceo@enterprise.com * **ID:** contact_8921 **Association:** 🔗 Linked to **Enterprise Corp** (company_789). Would you like to see the deal history for this company? ``` **Prompt:** ``` Show me the sales pipelines and the property schema for deals. ``` **Response:** ``` ### Sales Pipelines 1. **Sales Pipeline** (12 active deals) * Stages: Prospect (10%), Qualified (25%), Proposal (50%), Negotiation (75%), Closed Won (100%) 2. **Partnership Pipeline** (3 active deals) * Stages: Introduction, Evaluation, Agreement, Active Partner ### Deal Property Schema * **Key Fields:** `dealname`, `amount`, `dealstage`, `pipeline`, `closedate`, `hubspot_owner_id` * **Custom Fields:** `contract_length`, `implementation_fee`, `annual_recurring_revenue` Do you want to create a new deal in one of these pipelines? ``` ## Capabilities ### Create and manage contacts Add new people to your CRM or delete old records with a single command. ### Link CRM records Connect contacts to companies or deals to keep your data organized. ### Search leads with filters Find specific contacts using your existing HubSpot filter syntax. ### View sales pipelines See all your active deals, stages, and probabilities in one view. ### Audit property schemas List every available field for contacts, companies, or deals. ### Manage team records Identify all HubSpot users and see who owns which records. ## Use Cases ### Finding and creating leads An SDR asks their agent to find all contacts with an @enterprise.com email and create a new contact for the CEO. ### Reviewing pipeline health A sales manager asks for a list of all deals in the pipeline and wants to know which one has the highest value. ### Auditing CRM properties A marketing ops manager asks the agent to show the property schema for deals to see what custom fields are available. ### Linking records during research A RevOps analyst asks the agent to link three new contacts to the Acme Corp company record to keep the data synced. ## Benefits - Stop tab-switching by using list_contacts and list_deals directly in your chat window. - Keep your data clean by using link_crm_objects to connect records automatically without extra clicks. - Speed up lead generation with create_contact to add new people to your database as you talk to your agent. - Audit your data structure easily with get_object_schema to see every property available in your CRM. - Manage your team better by using list_hubspot_users to see who owns which records across the organization. - Find leads faster with search_contacts using your preferred filter syntax for targeted queries. ## How It Works The bottom line is you get a conversational interface for your entire HubSpot CRM. 1. Subscribe to the HubSpot MCP on Vinkius 2. Enter your HubSpot Private App Access Token 3. Ask your AI client to find, create, or update CRM records ## Frequently Asked Questions **Can I use the HubSpot MCP to add new leads to my CRM?** Yes, you can create new contacts directly through your AI agent. Just tell your agent the details of the person, and it will add them to your HubSpot database automatically. **Does the HubSpot MCP support linking records like contacts to companies?** Yes, it can create associations between different objects. You can ask your agent to link a specific contact to a company or a deal to keep your records organized. **Can I search for contacts using filters in the HubSpot MCP?** Yes, the Connector supports HubSpot filter syntax. This means you can ask for very specific groups of people, like those with certain email domains or job titles. **How do I see who owns which records in my HubSpot account?** You can ask your agent to list all HubSpot users and record owners. This helps you quickly identify who is responsible for specific accounts or deals. **Can I see what fields are available in my CRM using this Connector?** Yes, you can pull the property schema for any object type. This lets you see all the custom and standard fields available for contacts, companies, and deals. **Does the HubSpot MCP work with my existing HubSpot account?** Yes, it connects to your actual account. You just need to provide a HubSpot Private App Access Token to give your AI agent permission to manage your data. **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`.