HubSpot CRM MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on HubSpot CRM: 3 typed functions through one MCP server. No HubSpot CRM API key needed.
- Site
- app.hubspot.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just HubSpot CRM
An MCP server for HubSpot CRM alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/hubspotEvery site
One MCP server for HubSpot CRM and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 2
getDealReads one deal from the caller's own HubSpot CRM portal by its id.Arguments
Name Type Required dealIdstringYes Returns
HubspotDealDetailinterface HubspotDeal { id: string; name: string | null; /** Decimal string in the portal's currency. */ amount: string | null; stage: string | null; pipeline: string | null; closeDate: string | null; updatedAt: string | null; } interface HubspotDealDetail extends HubspotDeal { noteIds: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hubspot/getDealCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hubspot.getDeal({ dealId: "1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hubspot.getDeal({"dealId": "1"}))curl -X POST https://api.bowmark.ai/v1/sites/hubspot/getDeal \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"dealId":"1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hubspot.getDeal({ dealId: "1" });searchDealsSearches the deals in the caller's own HubSpot CRM portal by name ("Q4 direct mail") and returns each deal's id, name, amount, stage, pipeline and…Arguments
Name Type Required querystringWords from the deal's name, e.g. "Q4 direct mail".No limitnumber1-100, default 20.No Returns
SearchDealsResultinterface HubspotDeal { id: string; name: string | null; /** Decimal string in the portal's currency. */ amount: string | null; stage: string | null; pipeline: string | null; closeDate: string | null; updatedAt: string | null; } interface SearchDealsResult { deals: HubspotDeal[]; total: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hubspot/searchDealsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hubspot.searchDeals({ query: "direct mail" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hubspot.searchDeals({"query": "direct mail"}))curl -X POST https://api.bowmark.ai/v1/sites/hubspot/searchDeals \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"direct mail"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hubspot.searchDeals({ query: "direct mail" });
Act 1
addNoteToDealWrites a note onto a deal in the caller's own HubSpot CRM portal.Arguments
Name Type Required dealIdstringYes bodystringThe note text; HubSpot renders it as HTML.Yes timestampstringISO time the note is dated on the timeline.No Returns
HubspotNoteinterface HubspotNote { id: string; dealId: string; body: string; createdAt: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hubspot/addNoteToDealCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hubspot.addNoteToDeal({ dealId: "<dealId>", body: "<body>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hubspot.addNoteToDeal({"dealId": "<dealId>", "body": "<body>"}))curl -X POST https://api.bowmark.ai/v1/sites/hubspot/addNoteToDeal \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"dealId":"<dealId>","body":"<body>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hubspot.addNoteToDeal({ dealId: "<dealId>", body: "<body>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/hubspot/<function> - OpenAPI
/v1/sites/hubspot/openapi.json