How to Connect kintone MCP to an AI Agent
Auth setup
Easiest: In kintone app settings > API Token > generate token with needed permissions. Include as X-Cybozu-API-Token header. For multiple apps, combine tokens with comma.
Key facts
| Base URL | https://{subdomain}.cybozu.com/k/v1/ |
|---|
| API version | v1 |
|---|
| Auth | Three auth methods: 1) API Token (per-app, simplest), 2) Password auth (username:password base64 in X-Cybozu-Authorization header), 3) OAuth 2.0 (register at developer.cybozu.io). API Token is recommended for agent use. |
|---|
| Token URL | https://{subdomain}.cybozu.com/oauth2/token |
|---|
| Scopes | k:app_record:read,k:app_record:write |
|---|
| Request body | application/json |
|---|
| Pagination | offset: 'offset' param with 'totalCount: true' in query. Default limit 100, max 500. |
|---|
| Rate limit | 10,000 requests/day for standard plan. No per-minute limit documented, but concurrent connections limited to 10. |
|---|
| Error format | JSON: {"code":"GAIA_IL26","id":"xxx","message":"The record is not found."} |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /records.json | Get records from an app (supports query) |
POST | /records.json | Add new records to an app |
PUT | /records.json | Update existing records |
GET | /record.json | Get a single record by ID |
GET | /app/form/fields.json | Get app field definitions (schema) |
GET | /apps.json | List accessible apps |
Quickstart
GET /k/v1/records.json?app=1&query=status%3D%22Open%22 HTTP/1.1
Host: example.cybozu.com
X-Cybozu-API-Token: {api_token}
Response: {"records":[{"$id":{"value":"1"},"title":{"value":"タスクA"}}],"totalCount":"42"}
Agent pitfalls & tips
- Every field value is wrapped in {"value": "..."} — even numbers. Always access record.field_code.value.
- Field codes (フィールドコード) are the API names — different from display labels. Get them from /app/form/fields.json first.
- Base URL requires customer's subdomain: https://{subdomain}.cybozu.com. Ask the user for their subdomain.
- Query syntax is similar to SQL WHERE: 'status = "Open" and created_time > "2026-01-01"'. Use URL encoding.
- For multiple API tokens across apps, join with comma: 'X-Cybozu-API-Token: token1,token2'.
- Bulk operations: POST /records.json accepts up to 100 records at once.
- Process management (プロセス管理): use /record/status.json to advance workflow status.
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-04. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is kintone MCP's AEO score?
▼
kintone 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 kintone MCP AI-agent-ready?
▼
kintone 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 kintone MCP compare to other Project Management services?
▼
In the Project Management category, kintone 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 kintone MCP compares.
How can I integrate kintone MCP with an AI agent?
▼
The fastest way to integrate kintone 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 kintone MCP?
▼
Three auth methods: 1) API Token (per-app, simplest), 2) Password auth (username:password base64 in X-Cybozu-Authorization header), 3) OAuth 2.0 (register at developer.cybozu.io). API Token is recommended for agent use. Setup: Easiest: In kintone app settings > API Token > generate token with needed permissions. Include as X-Cybozu-API-Token header. For multiple apps, combine tokens with comma.
What are kintone MCP's API rate limits?
▼
10,000 requests/day for standard plan. No per-minute limit documented, but concurrent connections limited to 10.