How to Use the HubSpot CRM (Full) MCP in Cursor

Q: Can Cursor use HubSpot CRM (Full) to test deal creation?

It calls hscreatedeal to generate real opportunities in your pipeline. This lets you verify API payloads and webhook triggers without switching to a REST client.

Q: How does the HubSpot CRM (Full) server help Cursor write better sync scripts?

The agent runs hssearchcontacts to pull a live user record into your editor. It reads the exact lifecycle stages and associated company IDs to write accurate data mapping functions.

Q: Do I need to look up pipeline IDs manually when using this MCP Server?

No, the agent executes hslistpipelines to fetch the display order and stage IDs for you. It uses those exact IDs when generating code for ticket or deal creation.

Inject live HubSpot data straight into your code. Cursor Agent reads deals and contacts while you build CRM integrations.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HubSpot CRM (Full) MCP to Cursor

Create your Vinkius account to connect HubSpot CRM (Full) to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HubSpot CRM (Full) with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query pipelines inside your Cursor editor

Calling `hs_search_deals` and `hs_list_pipelines` lets Cursor pull real monetary amounts and stage labels directly into your workspace. When you write a custom dashboard, you don't have to guess the JSON structure of a sales opportunity. The agent fetches the actual deal names and expected close dates, using them to write accurate interface types for your frontend components. You can test write operations without leaving the IDE. Cursor calls `hs_create_deal` to push a test record into your default pipeline, letting you verify the webhook response immediately. It handles the API payload creation, assigning the dealstage and amount while you stay focused on the application logic.

Scaffold integrations with this MCP Server

This server provides `hs_search_companies` and `hs_search_contacts` so your AI client can grab live employee counts, domain names, and lifecycle stages. If you are writing a script to sync user accounts, Cursor reads a real contact record to understand the exact fields returned by the CRM. That means fewer broken builds caused by mismatched data models. The agent can also mock up user registration flows by executing `hs_create_contact`. It passes a unique email address to trigger the auto-deduplication logic, letting you see exactly how the CRM handles existing users. You build the sync logic while Cursor handles the tedious API testing steps.

Build support tools with live ticket data

Using `hs_search_tickets` and `hs_list_owners`, Cursor retrieves active support requests and the CRM users assigned to them. When you build an internal triage tool, the agent injects the real priority levels and pipeline categories into your test environment. You get working code that maps correctly to your actual support team structure. You can verify your submission forms by having the agent run `hs_create_ticket` and `hs_create_note`. It generates a test bug report, sets it to HIGH priority, and attaches an HTML-formatted note to the timeline. This proves your integration works before you ever push it to staging.

Setup guide

Set up HubSpot CRM (Full) MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the HubSpot CRM (Full) MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent HubSpot CRM (Full) transactions." If the MCP tools are loaded correctly, Cursor will call the HubSpot CRM (Full) tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "hubspot-crm-full-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HubSpot CRM (Full) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HubSpot CRM (Full) MCP in Cursor

Create a .cursor/mcp.json file in your project root and add the server details. Once saved, switch your chat to Agent mode so the editor can start calling the CRM tools.

It calls `hs_create_deal` to generate real opportunities in your pipeline. This lets you verify API payloads and webhook triggers without switching to a REST client.

The agent runs `hs_search_contacts` to pull a live user record into your editor. It reads the exact lifecycle stages and associated company IDs to write accurate data mapping functions.

No, the agent executes `hs_list_pipelines` to fetch the display order and stage IDs for you. It uses those exact IDs when generating code for ticket or deal creation.

The server processes sensitive fields like customer phone numbers, company revenue, and internal meeting notes. Vinkius isolates this traffic in an ephemeral environment, ensuring your proprietary sales data is never stored on disk or exposed to other workspace processes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript