How to Connect HubSpot Japan MCP to an AI Agent
Auth setup
Easiest: Settings > Integrations > Private Apps > Create. Select scopes needed. Copy access token. Use as: Authorization: Bearer {token}.
Key facts
| Base URL | https://api.hubapi.com/ |
|---|
| API version | v3 |
|---|
| Auth | OAuth 2.0 or Private App access token. Private app token is simplest — generate in HubSpot Settings > Integrations > Private Apps. Use as Bearer token. |
|---|
| Token URL | https://api.hubapi.com/oauth/v1/token |
|---|
| Scopes | crm.objects.contacts.read,crm.objects.contacts.write,crm.objects.deals.read |
|---|
| Request body | application/json |
|---|
| Pagination | cursor-based: response has 'paging.next.after' value. Pass as 'after' param. Default limit 10, max 100. |
|---|
| Rate limit | Private apps: 100 requests/10 seconds. OAuth apps: 100/10s. HTTP 429 with Retry-After. |
|---|
| Error format | JSON: {"status":"error","message":"...","correlationId":"...","category":"VALIDATION_ERROR"} |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /crm/v3/objects/contacts | List contacts |
POST | /crm/v3/objects/contacts | Create a contact |
GET | /crm/v3/objects/deals | List deals in pipeline |
POST | /crm/v3/objects/deals | Create a deal |
POST | /crm/v3/objects/contacts/search | Search contacts with filters |
Quickstart
GET /crm/v3/objects/contacts?limit=10&properties=email,firstname,lastname HTTP/1.1
Host: api.hubapi.com
Authorization: Bearer {token}
Response: {"results":[{"id":"123","properties":{"email":"tanaka@example.com","firstname":"太郎","lastname":"田中"}}]}
Agent pitfalls & tips
- [object Object]
- [object Object]
- [object Object]
- [object Object]
- [object Object]
- [object Object]
- [object Object]
- [object Object]
- [object Object]
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-06-08. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is HubSpot Japan MCP's AEO score?
▼
HubSpot Japan MCP has an AEO score of 0.90 and is rated AA (Strong agent support with minor gaps). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is HubSpot Japan MCP AI-agent-ready?
▼
HubSpot Japan MCP is currently ✓ verified for AI agent use. It offers an official MCP (Model Context Protocol) server, which means AI agents can connect directly. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does HubSpot Japan MCP compare to other CRM & Sales services?
▼
In the CRM & Sales category, HubSpot Japan MCP is rated AA. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how HubSpot Japan MCP compares.
How can I integrate HubSpot Japan MCP with an AI agent?
▼
The fastest way to integrate HubSpot Japan MCP with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with HubSpot Japan MCP?
▼
OAuth 2.0 or Private App access token. Private app token is simplest — generate in HubSpot Settings > Integrations > Private Apps. Use as Bearer token. Setup: Easiest: Settings > Integrations > Private Apps > Create. Select scopes needed. Copy access token. Use as: Authorization: Bearer {token}.
What are HubSpot Japan MCP's API rate limits?
▼
Private apps: 100 requests/10 seconds. OAuth apps: 100/10s. HTTP 429 with Retry-After.