# HubSpot MCP for AI Agents AI Agent Connect > HubSpot MCP lets you manage your entire CRM through natural conversation with your AI client. You can search contacts, update deals, and link records without ever opening a browser tab. Access all this via the Vinkius catalog. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_vSrdTRzZBErQPnMn4v0MxO89aHYHXt63cRk0554I/ai-agent-connect - **Tags:** contact-management, deal-pipelines, lead-nurturing, crm-integration, company-records, sales-operations ## Description Managing a CRM usually means an endless cycle of clicking through tabs, searching for specific email addresses, and manually updating deal stages. It's tedious work that pulls you away from actual selling or marketing strategy. This MCP changes that by letting your AI agent act as your personal CRM administrator. You can ask questions about your sales pipeline, find contact details, or check on company information using plain English. If you need to link a new lead to an existing account, you just tell your agent to do it. It handles the heavy lifting of navigating complex property schemas and associations behind the much simpler interface of your favorite AI client. By pulling your CRM data into your workspace via Vinkius, you turn your chat window into a powerful command center for your entire revenue operations. No more hunting for record owners or digging through nested amounts to see which deals are closing this month. Everything is just one question away. ## Tools ### list_hubspot_deals Pulls a list of all active sales deals in your pipeline. Use this to quickly check your current sales volume. ### get_hubspot_object_schema Shows every available field for contacts, companies, or deals. It's great for understanding your CRM structure. ### search_hubspot_contacts Finds specific people using HubSpot filter syntax. This makes locating leads in a large database easy. ### link_hubspot_crm_objects Connects different records like a contact to a company. Use this to keep your data associations organized. ### create_hubspot_contact Adds a brand new person to your CRM database. It's the fastest way to log a new lead during a chat. ### remove_hubspot_contact Deletes a contact from your records permanently. Use this to clean up your database quickly. ### get_hubspot_company_info Retrieves detailed metadata and information for any company. It's perfect for researching prospects. ### get_hubspot_contact_details Pulls all available property data for a specific person. Get the full picture of a lead instantly. ### get_hubspot_deal_details Fetches specific information about an individual sales deal. Use this to check amounts or closing dates. ### list_hubspot_companies Generates a list of all companies in your CRM. This helps you browse your entire account base. ### list_hubspot_contacts Displays all contacts currently stored in your database. It's useful for getting a high-level view of your leads. ### list_hubspot_users Shows the users and record owners within your HubSpot account. Use this to see who is responsible for which accounts. ## Prompt Examples **Prompt:** ``` Show me all the deals in my pipeline that are currently in the negotiation stage. ``` **Response:** ``` You have 3 deals in Negotiation: - **Acme Corp Migration**: $25,000 - **Globex Expansion**: $12,500 - **Soylent Green Contract**: $45,000 **Total value in this stage**: $82,500 ``` **Prompt:** ``` Find the contact info for Sarah Jenkins at TechFlow Inc. ``` **Response:** ``` I found Sarah Jenkins: - **Email**: sarah.j@techflow.io - **Phone**: +1 (555) 012-3456 - **Job Title**: Director of Operations - **Associated Company**: TechFlow Inc. ``` **Prompt:** ``` Create a new contact for Mike Ross at Pearson Specter. ``` **Response:** ``` Contact created successfully! - **Name**: Mike Ross - **Company**: Pearson Specter - **Status**: New Lead Would you like me to link him to an existing company record? ``` ## Capabilities ### Manage contacts Create, find, or remove people from your database. ### Track sales pipelines View deal amounts, stages, and progress. ### Inspect company records Browse details and metadata for any organization. ### Link CRM objects Connect contacts to companies or deals seamlessly. ### Audit data schemas Check all available properties and fields for any object type. ### Monitor team activity See which users own specific records in your CRM. ## Use Cases ### Finding leads during outreach You're drafting an email and need a contact's phone number. Ask your agent to find the details, and it pulls them from HubSpot instantly. ### Updating deal progress A prospect just signed. Tell your agent to move the deal to "Closed Won" so your pipeline stays accurate without manual entry. ### Cleaning up messy associations You noticed a contact isn't linked to their company. Ask your agent to link them, and the relationship is updated immediately. ### Auditing property fields You need to know if "annual_revenue" is a valid field for deals. Ask your agent to check the schema and get the answer in seconds. ## Benefits - Stop clicking: Update deal stages and contact info without opening the HubSpot dashboard. - Instant lookups: Find any contact or company detail using simple text queries. - Cleaner data: Link contacts to companies or deals via a single command. - Better visibility: Monitor your entire sales pipeline and deal amounts in one view. - Easier auditing: Check property schemas and field types without digging through settings. ## How It Works The bottom line is you turn a chat interface into a functional CRM dashboard. 1. Subscribe to the HubSpot MCP on Vinkius. 2. Provide your HubSpot Private App Access Token. 3. Start asking your AI client questions about your contacts, deals, or companies. ## Frequently Asked Questions **How can I use HubSpot MCP to find leads?** You can search your entire database using natural language. Just ask your agent to find contacts based on specific criteria or email domains. **Can the HubSpot MCP update my sales pipeline?** Yes, you can instruct your agent to move deals between stages or update amounts directly through your chat interface. **Does HubSpot MCP work with Claude and Cursor?** Absolutely. Any MCP-compatible client like Claude, Cursor, or Windsurf can connect to this tool to manage your CRM. **Can I check my company details using HubSpot MCP?** Yes, you can retrieve full metadata and information for any organization in your database without opening a browser. **Is it possible to link contacts to companies with HubSpot MCP?** Yes, you can use the tool to create associations between different CRM objects like contacts, companies, and deals. **How do I set up the HubSpot MCP?** Simply subscribe via Vinkius and enter your HubSpot Private App Access Token to connect your data. **Can I search for contacts using specific filters?** Yes. The `search_hubspot_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_hubspot_object_schema` with 'contacts' to discover all searchable properties. **Can I link contacts to companies and deals?** Yes. Use `link_hubspot_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`.