4,000+ servers built on MCP Fusion
Vinkius
WindsurfIDE
Why use HubSpot CRM MCP Server with Windsurf?

Bring Contact Management
to Windsurf

Create your Vinkius account to connect HubSpot CRM to Windsurf and start using all 10 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.

MCP Inspector GDPR Free for Subscribers
Hs Create CompanyHs Create ContactHs Create NoteHs Create TaskHs Get AssociationsHs Get ContactHs Search CompaniesHs Search ContactsHs Update CompanyHs Update Contact
ChatGPT Claude Perplexity

Compatible with every major AI agent and IDE

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
HubSpot CRM

What is the HubSpot CRM MCP Server?

Connect HubSpot CRM to any AI agent — instant access to your full CRM data without switching tabs.

What you can do

  • Contacts — Search, create, and manage contacts
  • Companies — Find companies by name or domain
  • Deals — Search and create deals with pipeline tracking
  • Tickets — Create and search support tickets
  • Notes — Create notes attached to any CRM record
  • Owners — View all owners and team assignments
  • Pipelines — List deal and ticket pipeline stages

Who is this for?

  • Sales Reps — Manage your CRM without leaving your AI assistant
  • Support Teams — Create tickets and notes on-the-go
  • RevOps — Pipeline snapshots and owner assignments
  • Managers — Full CRM visibility through conversation

Built-in capabilities (10)

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

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

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

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

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

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

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

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

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

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

Why Windsurf?

Windsurf's Cascade agent chains multiple HubSpot CRM tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 10 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

  • Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention

  • Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively

  • JSON-based configuration means zero code changes: paste a URL, reload, and all 10 tools are immediately available

  • Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

See it in action

HubSpot CRM in Windsurf

AI AgentVinkius
High Security·Kill Switch·Plug and Play
Enterprise Security

Why run HubSpot CRM with Vinkius?

The HubSpot CRM connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 10 tools are ready to work instantly without any complex setup.

You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.

HubSpot CRM
Fully ManagedNo server setup
Plug & PlayNo coding needed
SecurePrivacy protected
PrivateYour data is safe
Cost ControlBudget limits
Control1-click disconnect
Auto-UpdatesMaintenance free
High SpeedOptimized for AI
Reliable99.9% uptime
Your credentials and connection tokens are fully encrypted

* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure

01 / Catalog

Over 4,000 integrations ready for AI agents

Explore a vast library of pre-built integrations, optimized and ready to deploy.

02 / Credentials

Connect securely in under 30 seconds

Generate tokens to authenticate and link external services in a single step.

03 / Guardian

Complete visibility into every agent action

Audit live requests, latency, success rates, and active security compliance policies.

04 / FinOps

Optimize spending and track token ROI

Analyze real-time token consumption and cost metrics detailed by connection.

Over 4,000 integrations ready for AI agents
Connect securely in under 30 seconds
Complete visibility into every agent action
Optimize spending and track token ROI

Explore our live AI Agents Analytics dashboard to see it all working

This dashboard is included when you connect HubSpot CRM using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.

Why Vinkius

HubSpot CRM and 4,000+ other AI tools. No hosting, no code, ready to use.

Professionals who connect HubSpot CRM to Windsurf through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.

4,000+MCP Integrations
<40msResponse time
100%Fully managed
Raw MCP
Vinkius
Ready-to-use MCPsFind and configure each manually4,000+ MCPs ready to use
Connection SetupManual coding & server setup1-click instant connection
Server HostingYou host it yourself (needs 24/7 uptime)100% hosted & managed by Vinkius
Security & PrivacyStored in plaintext config filesBank-grade encrypted vault
Activity VisibilityBlind execution (no logs or tracking)Live dashboard with real-time logs
Cost ControlRunaway AI token spend riskAutomatic budget limits
Revoking AccessMust delete files or code to stop1-click disconnect button
The Vinkius Advantage

How Vinkius secures HubSpot CRM for Windsurf

Every request between Windsurf and HubSpot CRM is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.

< 40msCold start
Ed25519Signed audit chain
60%Token savings
FAQ

Frequently asked questions

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.

04

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.

05

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.

06

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.

07

Server not connecting

Check Settings → MCP for the server status. Try toggling it off and on.

Explore More MCP Servers

View all →