← Back to directory
K

kintone MCP Server

Official
kintone's official local MCP server for managing apps, records, and spaces
GitHub source repository ↗
★ 54 Stars Category · Database Popular Source revision 79cb69826236
53FMRS · D
Reliability
8/20
Security and permissions
3/20
Maintenance
14/20
Documentation
15/20
Setup experience
13/20

kintone MCP Server is Cybozu's official, open-source (Apache-2.0) local MCP server that exposes about 25 tools over the kintone REST API for managing apps, fields, forms, records, and spaces. It supports MCPB, Docker, and npm installs plus multiple auth methods, but does not support guest spaces and is explicitly outside kintone's official API support channel, with issues tracked via GitHub.

Read the FMRS scoring method →

An official local MCP server maintained by Cybozu that connects to the kintone REST API. It provides tools to manage apps, form fields and layouts, process management, general settings, records (CRUD plus comments and status updates), attachment downloads, and spaces (create from template, update, delete). It can be installed as an MCPB package for Claude Desktop, a Docker image, or an npm package, and supports username/password, API token, Basic auth, or client certificate authentication.

Tools

kintone-get-apps
Get information for multiple apps
kintone-get-app
Get detailed information for a single app
kintone-get-form-fields
Get an app's field settings
kintone-get-form-layout
Get an app's form layout
kintone-update-form-fields
Update an app's field settings
kintone-update-form-layout
Update an app's form layout
kintone-delete-form-fields
Delete fields from an app
kintone-get-process-management
Get process management settings
kintone-get-app-deploy-status
Check whether app settings have been deployed to the production environment
kintone-get-general-settings
Get an app's general settings
kintone-add-form-fields
Add fields to an app
kintone-get-records
Retrieve multiple records
kintone-add-records
Add multiple records
kintone-update-records
Update multiple records
kintone-delete-records
Delete multiple records
kintone-update-statuses
Update the status of multiple records
kintone-get-record-comments
Get comments on a record
kintone-add-record-comment
Add a comment to a record
kintone-add-app
Create an app in the test environment
kintone-deploy-app
Deploy app settings to the production environment
kintone-update-general-settings
Change an app's general settings
kintone-download-file
Save files from an attachment field
kintone-add-space-from-template
Create a space from a template
kintone-update-space
Update space settings
kintone-get-space
Get information about a space
kintone-delete-space
Delete a space

Setup

1) MCPB: download kintone-mcp-server.mcpb from the GitHub Releases page, drag it into Claude Desktop's Extensions page, confirm the install, then enter the kintone Base URL, username, and password in the setup dialog. 2) Docker: install Docker, then run docker run -i --rm -e KINTONE_BASE_URL=... -e KINTONE_USERNAME=... -e KINTONE_PASSWORD=... ghcr.io/kintone/mcp-server, or configure it as a stdio command in your client's mcp.json. 3) npm: run npm install -g @kintone/mcp-server, then launch with kintone-mcp-server --base-url ... --username ... --password ... (or the equivalent environment variables).

claude_desktop_config.json
{"mcpServers":{"kintone":{"type":"stdio","command":"docker","args":["run","-i","--rm","-e","KINTONE_BASE_URL","-e","KINTONE_USERNAME","-e","KINTONE_PASSWORD","ghcr.io/kintone/mcp-server:latest"],"cwd":"${cwd}","env":{"KINTONE_BASE_URL":"https://example.cybozu.com","KINTONE_USERNAME":"username","KINTONE_PASSWORD":"password"}}}}

Fit and risk

Best for

  • Teams already using the kintone platform who want an AI assistant to operate on apps and records
  • Administrators who need to bulk-maintain kintone fields, forms, or general settings
  • Developers who want to drive kintone REST API operations via natural language

Not for

  • Users who do not use the kintone platform
  • Scenarios requiring access to apps inside kintone guest spaces (unsupported)
  • Bulk record imports that need to set attachment field contents directly (unsupported)

Required permissions

  • A kintone login username and password, or API token(s) (up to 9, comma-separated)
  • Optional Basic auth username and password
  • Optional client certificate (PFX file and password) for secure-access domains
  • Actual app access depends on the View/Add/Edit/Delete kintone permissions granted to the account or token used

Risks and side effects

  • The server can directly call the kintone REST API to add, update, and delete records, fields, and app settings, so mistakes can cause data loss or broken app configurations
  • Credentials (password, API token, client certificate password) are passed via command-line arguments or environment variables, so config files and env vars must be protected from exposure
  • Guest space apps are not supported, which can cause access issues if business processes rely on them
  • The README states this server is outside kintone's official API support channel; issues must be reported via GitHub Issues

Troubleshooting

  1. Connection errors: verify the Base URL is correct (e.g. https://example.cybozu.com), set the HTTPS_PROXY environment variable if behind a proxy, and retry after a few minutes for transient failures
  2. Authentication errors: verify the username and password; do not specify username/password and an API token together (password auth takes priority if both are set); when using a client certificate, confirm you're using the secure-access domain (e.g. .s.cybozu.com)
  3. Permission errors: confirm the user or API token has access to the target app (app management or record view permission may be required); confirm the app is not in a guest space; when using an API token, confirm it has been granted the needed View/Add/Edit/Delete permissions
  4. Before using kintone-download-file, you must set --attachments-dir or KINTONE_ATTACHMENTS_DIR to a save directory or the tool call will error; a nonexistent directory will be created automatically

Use cases

Let an AI assistant query and summarize record data in kintone apps
Bulk add, update, or delete kintone records
Manage kintone app fields, form layouts, and general settings
Deploy app configuration changes from the test environment to production
Create and manage kintone spaces and record comments

Supported clients

Claude DesktopFull support
Claude CodePartial support
CursorPartial support