How to Use the HubSpot Sales Hub MCP in LangChain

Q: How do I initialize the HubSpot Sales Hub tools in LangChain?

Install langchain-mcp-adapters. Initialize a MultiServerMCPClient pointing to your Vinkius endpoint, then call client.gettools(). Pass that list directly to your ReAct agent.

Q: Can LangChain agents update HubSpot Sales Hub deals automatically?

Yes. The agent uses hssearchdeals to find the target record, then calls hsupdatedeal to change the stage or amount. You control the exact conditions that trigger these updates in your chain logic.

Give your LangChain agents direct access to HubSpot pipelines and deals. Build multi-step sales workflows with full observability.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HubSpot Sales Hub MCP to LangChain

Create your Vinkius account to connect HubSpot Sales Hub to LangChain 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 Sales Hub with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build automated deal chains in LangChain

`hs_create_deal` and `hs_update_deal` let your LangChain agents create and modify sales opportunities directly from intermediate chain outputs. You set up a ReAct agent, and it decides when to push a deal to the next stage based on previous steps. If a prospect agrees to terms in an email parsing step, the agent immediately updates the deal amount and close date. The pipeline relies on accurate stage IDs to function. Your agent pulls the exact internal ID using `hs_list_pipelines` before making any modifications. This ensures the update lands exactly where it should, without manual intervention or broken references.

Trace HubSpot Sales Hub MCP Server calls

`hs_deals_by_stage` and `hs_search_deals` pull pipeline data into your LangSmith traces. You can see exactly what revenue numbers your agent retrieved before it generated a forecast report. The framework logs latency and token usage for every single read operation against the CRM. When your multi-agent setup needs context on specific accounts, it queries the CRM first. The agent chains the output of these searches directly into the next prompt. You track exactly how the agent reasoned about the pipeline data before taking action.

Connect quotes and meetings to custom logic

`hs_list_quotes` and `hs_list_meetings` feed past interaction data into your LangChain workflows. Your agent pulls recent meeting outcomes and pending proposal statuses to decide if a follow-up action is necessary. It grabs the exact timestamps and participant lists from logged calendar syncs. You combine this CRM data with external databases or document stores in the same chain. The agent reads the meeting notes, checks the associated deal, and drafts a precise follow-up message based on the actual conversation history.

Setup guide

Set up HubSpot Sales Hub MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes HubSpot Sales Hub tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "hubspot-sales-hub-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent HubSpot Sales Hub transactions"
    })
    print(result["messages"][-1].content)

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 Sales Hub 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 Sales Hub MCP in LangChain

Install `langchain-mcp-adapters`. Initialize a `MultiServerMCPClient` pointing to your Vinkius endpoint, then call `client.get_tools()`. Pass that list directly to your ReAct agent.

Yes. The agent uses `hs_search_deals` to find the target record, then calls `hs_update_deal` to change the stage or amount. You control the exact conditions that trigger these updates in your chain logic.

Every MCP tool invocation against the HubSpot API logs directly to LangSmith. You see the exact JSON inputs sent to the CRM and the responses returned.

The MCP standard lets the agent fix its own errors. If it tries to create a deal without a stage ID, it will call `hs_list_pipelines` to find the correct internal reference and try again.

Vinkius runs your server in an ephemeral V8 Isolate sandbox. Your sensitive deal amounts, quote totals, and meeting participant lists exist only during the execution of the request. The environment destroys itself immediately after the HTTP response, leaving zero trace of your pipeline data.

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