# Kintone — how to use (mcp.ai)

Connect your Kintone account and use 16 tools for human resources straight from your AI agent. Connect with your own API key. Manage users, departments, groups, memberships, service assignments, and login codes in a Kintone tenant through the User API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kintone?ms=1787293920000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kintone_change_login_codes`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kintone`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kintone/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kintone/change/login/codes` — Irreversibly change the login codes of up to 100 Kintone users in one batch. Warning: this changes user identities and cannot be undone automatically.
  - body: { changes: object[] }
- `POST https://api.mcp.ai/api/kintone/create/departments` — Create 1 to 100 Kintone departments in one batch. Submit parent departments before their children when creating a hierarchy.
  - body: { departments: object[] }
- `POST https://api.mcp.ai/api/kintone/create/groups` — Create 1 to 100 static or dynamic Kintone groups in one batch. Each group requires a unique code, name, and membership type.
  - body: { groups: object[] }
- `POST https://api.mcp.ai/api/kintone/create/users` — Create 1 to 100 Kintone tenant users in one batch with a login code, password, and display name for each user.
  - body: { users: object[] }
- `POST https://api.mcp.ai/api/kintone/delete/directory/resources` — Permanently delete a non-empty batch of Kintone users, departments, or groups by exact code. Deleted resources cannot be recovered by this tool. Deleting a department may also delete all of its child 
  - body: { codes: string[], resource_type: string, confirm_department_cascade?: boolean }
- `POST https://api.mcp.ai/api/kintone/get/user/access` — Get one user's department memberships, group memberships, and Kintone service assignment in one read.
  - body: { user_code: string }
- `POST https://api.mcp.ai/api/kintone/list/directory/containers` — List or filter Kintone departments or groups, one page at a time.
  - body: { ids?: string[], size?: integer, codes?: string[], next_cursor?: string, resource_type: string }
- `POST https://api.mcp.ai/api/kintone/list/members` — List users belonging to a Kintone department or group, one page at a time.
  - body: { code?: string, size?: integer, next_cursor?: string, container_type?: string }
- `POST https://api.mcp.ai/api/kintone/list/users` — List or filter tenant users by ID or login code, one page at a time.
  - body: { ids?: string[], size?: integer, codes?: string[], next_cursor?: string }
- `POST https://api.mcp.ai/api/kintone/replace/group/users` — Replace a Kintone static group's complete user membership list. The submitted list is a complete replacement: omitted existing users are removed, and an empty list removes all.
  - body: { group_code: string, user_codes: string[] }
- `POST https://api.mcp.ai/api/kintone/replace/user/departments` — Replace the complete department membership lists for one to 100 Kintone users. Each submitted list is a complete replacement: omitted existing department memberships are removed, and an empty list rem
  - body: { user_departments: object[] }
- `POST https://api.mcp.ai/api/kintone/replace/user/groups` — Replace a Kintone user's complete static-group membership list. The submitted list is a complete replacement: omitted existing group memberships are removed, and an empty list removes all.
  - body: { user_code: string, group_codes: string[] }
- `POST https://api.mcp.ai/api/kintone/set/service/assignments` — Replace Kintone service access for one to 100 users. An empty services array disables access, so omitted existing assignments are removed.
  - body: { users: object[] }
- `POST https://api.mcp.ai/api/kintone/update/departments` — Update mutable fields for 1 to 100 existing Kintone departments, identified by exact department code.
  - body: { departments: object[] }
- `POST https://api.mcp.ai/api/kintone/update/groups` — Update the name and optional description of 1 to 100 existing Kintone groups, identified by exact group code. Group type cannot be changed.
  - body: { groups: object[] }
- `POST https://api.mcp.ai/api/kintone/update/users` — Update editable profile and primary-organization fields for 1 to 100 existing Kintone tenant users identified by login code.
  - body: { users: object[] }

## Example prompts
- "What can I do in Kintone?"
- "Show me a summary of my Kintone account"

## More
- Page: https://mcp.ai/kintone
- Agent spec (llms.txt): https://mcp.ai/kintone/llms.txt
- Postman collection: https://mcp.ai/kintone/postman.json