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
MCP serverOfficial

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.
All reasons and checks

kintone/mcp-server

Install

Manual install

npm install -g @kintone/mcp-server

npm package from the README. The server starts with `kintone-mcp-server` and the sign-in options.

Access and checks

How we review

Broad 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_URL required
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_PASSWORD secret
Password for login authentication.
KINTONE_API_TOKEN secret
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.

Official

Zapier's official MCP plugin: the agent gets actions across thousands of apps through your Zapier account

PluginBroad access458Repository stars

Microsoft Power Platform MCP server with 312 tools for flows, apps, Dataverse and Power Pages, driven in plain language.

MCP serverBroad access102Repository stars

An MCP server for driving Windows: the agent opens apps, clicks and types, reads window and UI state, and works with files and PowerShell

MCP serverBroad access11.6KRepository stars
Official

SeldonFrame MCP server and plugin: an agent builds a client site, booking flow, CRM and AI agent from one request

MCP serverBroad access70Repository stars

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.

README badge

Report a problem