How to Use the HubSpot CRM (Full) MCP in Vercel AI SDK

Q: How does Vercel AI SDK handle duplicate entries when using HubSpot CRM (Full)?

The hscreatecontact tool automatically deduplicates contacts by their unique email address. When your Vercel AI SDK client attempts to write a contact that already exists, HubSpot merges the data instead of creating a duplicate.

Q: Can I stream deal pipelines using Vercel AI SDK and HubSpot CRM (Full)?

Yes, you query pipelines using hslistpipelines and stream the stage IDs directly to your frontend. Your Vercel AI SDK client renders the stages as they load, allowing users to see pipeline structures instantly.

Q: How do I assign owners to deals in Vercel AI SDK with HubSpot CRM (Full)?

First, fetch your active team members using hslistowners to get their specific HubSpot IDs. Then, pass the selected owner ID into hscreatedeal within your Vercel AI SDK MCP Server configuration.

Q: How do I log rich-text meeting summaries to a contact's timeline?

Use hscreatenote with HTML formatting in the body parameter to log structured notes. Pass the contact ID returned by hssearchcontacts to associate the note directly with that person's history in Vercel AI SDK.

Build real-time sales dashboards and customer portals with Vercel AI SDK streaming live HubSpot CRM data directly into your React frontend.

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 Vercel AI SDK

Create your Vinkius account to connect HubSpot CRM (Full) to Vercel AI SDK 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 Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream contact updates live to React components

The `hs_create_contact` tool handles contact creation by deduplicating entries via email and updating the lifecycle stage instantly. Your Vercel AI SDK client calls this MCP tool and streams the resulting HubSpot ID and contact details straight to your UI as the agent works. This setup avoids boring loading spinners in your Next.js app while HubSpot updates. Users watch their Vercel AI SDK interface render HubSpot contact updates in real-time.

Build interactive deal boards with this MCP Server

The `hs_search_deals` tool retrieves pipeline status, expected close dates, and monetary amounts for active sales opportunities. Your Vercel AI SDK app renders these HubSpot deals inside interactive UI elements the moment the search query returns. Combine this with `hs_create_deal` and `hs_list_pipelines` to let users build and edit deals without leaving your Next.js application. Your Vercel AI SDK frontend updates dynamically as the underlying HubSpot CRM state changes.

Log customer support tickets instantly from the edge

The `hs_create_ticket` tool submits new customer issues directly into the default support pipeline with specified priorities and pipeline stages. This tool runs on edge functions inside Vercel AI SDK, keeping latency low when users submit feedback to HubSpot Service Hub. You can immediately attach context using `hs_create_note` to log the conversation history on the ticket timeline. The customer gets confirmation immediately in their Vercel AI SDK chat interface while your support team sees the updated ticket in HubSpot.

Setup guide

Set up HubSpot CRM (Full) MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all HubSpot CRM (Full) tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent HubSpot CRM (Full) transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

The `hs_create_contact` tool automatically deduplicates contacts by their unique email address. When your Vercel AI SDK client attempts to write a contact that already exists, HubSpot merges the data instead of creating a duplicate.

Yes, you query pipelines using `hs_list_pipelines` and stream the stage IDs directly to your frontend. Your Vercel AI SDK client renders the stages as they load, allowing users to see pipeline structures instantly.

First, fetch your active team members using `hs_list_owners` to get their specific HubSpot IDs. Then, pass the selected owner ID into `hs_create_deal` within your Vercel AI SDK MCP Server configuration.

Use `hs_create_note` with HTML formatting in the body parameter to log structured notes. Pass the contact ID returned by `hs_search_contacts` to associate the note directly with that person's history in Vercel AI SDK.

Your sensitive CRM data, including contacts, deals, and tickets, stays protected through Vinkius's zero-trust sandboxed execution environment. The MCP Server acts as an ephemeral bridge, passing data directly to your Vercel deployment without storing credentials or records on our servers.

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