Kintone Mcp Server

What is Kintone MCP Server?

An official local MCP (Model Context Protocol) server for kintone, enabling AI assistants to interact with kintone apps, records, spaces, and settings via a set of tools.

How to use Kintone MCP Server?

Install via MCPB (Claude Desktop extension), Docker container, or npm package. Configure with command-line arguments or environment variables: KINTONE_BASE_URL, KINTONE_USERNAME/KINTONE_PASSWORD or KINTONE_API_TOKEN, and optional KINTONE_BASIC_AUTH_USERNAME, KINTONE_BASIC_AUTH_PASSWORD, KINTONE_PFX_FILE_PATH, KINTONE_PFX_FILE_PASSWORD, HTTPS_PROXY, KINTONE_ATTACHMENTS_DIR. Use in AI tools like Claude Code or Cursor by referencing a JSON configuration file (e.g., .mcp.json or .cursor/mcp.json).

Key features of Kintone MCP Server

• Manage kintone apps: get, create, deploy, update fields and layouts.
• Record operations: get, add, update, delete records and statuses.
• Comment handling: get and add comments on records.
• File attachment download: save files to a specified directory.
• Space management: create, update, and get space information.
• Support for password, API token, and client certificate authentication.

Use cases of Kintone MCP Server

• Automate app creation and field configuration via AI assistant.
• Bulk record operations (add, update, delete) based on natural language instructions.
• Download files attached to records for local processing.
• Manage app deployment status and general settings without the kintone UI.
• Integrate kintone workflows with AI-driven conversation agents.

FAQ from Kintone MCP Server

How do I install the Kintone MCP Server?

You can install via MCPB (drag and drop into Claude Desktop), Docker (docker run ... ghcr.io/kintone/mcp-server), or npm (npm install -g @kintone/mcp-server).

What authentication methods are supported?

Password authentication (username + password) or API token (up to 9 tokens, comma-separated). Client certificate authentication is also supported by specifying a PFX file path and password.

Can I use the Kintone MCP Server behind a proxy?

Yes, set the HTTPS_PROXY environment variable (e.g., http://proxy.example.com:8080). Authenticated proxies are also supported.

Are there any limitations?

Guest space apps are not accessible. Attachment fields cannot be used in record add/update tools. User/org/group selection fields require pre-set choices. The kintone-download-file tool requires the KINTONE_ATTACHMENTS_DIR environment variable.

What if I get connection or authentication errors?

Check the base URL format (e.g., https://example.cybozu.com). Verify credentials and ensure no conflict between password and API token. For client certificates, use the secure domain (e.g., .s.cybozu.com). If using a proxy, set HTTPS_PROXY.