kintone MCP Server
Official Cybozu MCP server: an agent reads and changes kintone apps, records and spaces through the REST API.
- 59 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- The tools change and delete records, form fields and whole spaces in the production kintone environment.
- A password or API token gives the agent the account's rights across every app it can reach.
Install
- Works in
Manual install
npm install -g @kintone/mcp-servernpm package from the README. The server starts with `kintone-mcp-server` and the sign-in options.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The tools change and delete records, form fields and whole spaces in the production kintone environment.
- A password or API token gives the agent the account's rights across every app it can reach.
This is third-party code. Review the repository files before installing.
What it does
Cybozu's local MCP server connects an agent to the kintone cloud platform. It exposes 27 tools: listing apps and field settings, reading, adding, updating and deleting records, moving process statuses, record comments and attachment downloads. The server also administers. It creates an app in the test environment, adds fields, edits the form layout, pushes settings to production with `kintone-deploy-app` and creates a space from a template. Sign-in uses a login and password or an API token, and Basic authentication, a PFX client certificate and a proxy are supported.
Who it is for. kintone administrators and developers who would rather describe an app change in words than hunt for the setting in the interface.
Good fit when
- Hundreds of records sit in an app and a batch has to be found, updated or deleted by a condition.
- An app form has grown extra fields and the layout is easier to rearrange by asking an agent.
- Requests from one selection move to the next process status in a single pass.
- A new space with a set of apps is created from a template for a department.
Not a fit when
- The apps live in guest spaces: the server cannot see them.
- A file has to be attached to a record: an attachment field cannot be set on write.
- You expect API support from Cybozu: the local MCP server is outside the API support scope.
Example request
Find records in the Requests app with status Pending approval older than two weeks and show them as a table.MCP
- Transport
- stdio
- Authentication
- key is optional
Environment variables
KINTONE_BASE_URLrequired- Base URL of the kintone environment, for example `https://example.cybozu.com`.
KINTONE_USERNAME- Login name. Required together with `KINTONE_PASSWORD` when no API token is set.
KINTONE_PASSWORDsecret- Password for login authentication.
KINTONE_API_TOKENsecret- API token, up to nine separated by commas. Alternative to login and password.
KINTONE_ATTACHMENTS_DIR- Folder for downloaded attachments. Without it `kintone-download-file` returns an error.
Limitations
Guest spaces are not supported, so apps inside them are unreachable. Attachment fields cannot be set on write, and user, organization and group selection fields can be filled only when options are defined. Downloading attachments needs `KINTONE_ATTACHMENTS_DIR`, otherwise the tool returns an error. The local server is outside the API support scope, so bugs go through Issues. If both a password and an API token are set, the password wins.
How to disable. Remove the `kintone` entry from `.mcp.json` or the client config. The Claude Desktop extension is turned off on the extensions page. Revoke the issued API token in the kintone app settings.
FAQ
How do I connect kintone MCP Server to Claude Code?
Add a `kintone` entry to `.mcp.json` with the command `docker`, the image `ghcr.io/kintone/mcp-server:latest` and the variables `KINTONE_BASE_URL`, `KINTONE_USERNAME`, `KINTONE_PASSWORD`. The README carries a sample config. After restarting the client, tools prefixed `kintone-` appear in the list.
What credentials are needed?
The environment URL in `KINTONE_BASE_URL` and one of two options: login with password or an API token. Up to nine tokens can be listed, separated by commas. If both are set, the server uses the password.
Can the server delete records?
Yes. `kintone-delete-records`, `kintone-delete-form-fields` and `kintone-delete-space` exist. If the agent should only read, create an API token with view permission and without change and delete permissions.
How do I run it without Docker?
Run `npm install -g @kintone/mcp-server`, then `kintone-mcp-server --base-url https://example.cybozu.com --api-token (token)`. Environment variables accept the same values.
Does the server work with guest spaces?
No. Apps inside guest spaces are unreachable and the server returns an access error for them.
Discussion
No questions or reviews yet.
Related
MCP serversThe Apideck MCP server: an agent works with over 200 business systems: accounting, HRIS, CRM and files through one unified API
Zapier's official MCP plugin: the agent gets actions across thousands of apps through your Zapier account
Microsoft Power Platform MCP server with 312 tools for flows, apps, Dataverse and Power Pages, driven in plain language.
An MCP server for driving Windows: the agent opens apps, clicks and types, reads window and UI state, and works with files and PowerShell
A third-party MCP server with 101 tools for Kingdee Cloud Star ERP: purchasing, sales, stock, finance and attachments
SeldonFrame MCP server and plugin: an agent builds a client site, booking flow, CRM and AI agent from one request
README in short
The README is in Japanese with an English version. Installation has three paths: an MCPB package for Claude Desktop, a Docker image and an npm package. It then lists sign-in options, the 27 tools, limitations and fixes for common connection and permission errors.