Connect the HubSpot API
Integrate the HubSpot API through Modiva’s unified REST API and hosted MCP server. Read & write contacts and deals in HubSpot CRM. OAuth, token refresh, rate limits and 7 typed tools are handled for you — connect once and call HubSpot from any agent or app through a single endpoint.
What you can do with the HubSpot API
- ✓ Contacts
- ✓ Deals
- — Companies
- ✓ Token refresh
- — Webhooks (Poll via the contacts/deals tools)
HubSpot MCP tools & scopes
- accounts_
- get · identity
- contacts_
- list · get · create · update
- deals_
- list · create
OAuth scopes requested
- Read your account identity
- Read & write contacts
- Read & write deals
Connect HubSpot in your agent
# Add Modiva's MCP server to your agent
{
"mcpServers": {
"modiva": {
"url": "https://mcp.modiva.ai",
"headers": { "Authorization": "Bearer $MODIVA_MCP_KEY" }
}
}
}
# Then connect HubSpot and call its tools, e.g.
accounts_list(provider="hubspot")Frequently asked questions
How do I connect the HubSpot API with Modiva?
Create a Modiva account, generate an MCP key, and connect HubSpot from your dashboard. Modiva runs the full OAuth flow and stores the encrypted token for you — no client secrets in your code.
What can I do with the HubSpot API through Modiva?
Read & write contacts and deals in HubSpot CRM. You get 7 typed tools grouped by resource (accounts_, contacts_, deals_), callable over REST or the MCP server.
Do I need to handle OAuth or token refresh myself?
No. Modiva handles the HubSpot OAuth handshake, token storage (envelope-encrypted) and automatic refresh. You call a single unified endpoint.
Can an AI agent use the HubSpot API?
Yes — that is the point. Modiva exposes HubSpot as Model Context Protocol (MCP) tools, so agents like Claude, Cursor or your own app can read and act on HubSpot through one endpoint.