This MCP server provides a bridge to kintone for Claude Desktop and other MCP-hosting clients. It exposes a suite of tools that let you read and manipulate kintone data, such as getting a single record, searching records, creating or updating records, uploading and downloading files, and retrieving app metadata like form layouts, fields, views, and notifications. The server is configured to connect to a kintone domain using a designated username and password, and it runs a Node.js-based MCP server script (server.js). To use it, install and run the server, then load the unofficial-kintone-mcp-server extension in Claude Desktop (via the Claude Desktop settings under Extensions) and enable the kintone MCP server. Once loaded, open a new chat and select the kintone MCP server to access its tools. You can enable/disable specific tools through the extension interface to tailor the available capabilities to your workflow. The documented tool list includes record operations (get_record, search_records, create_record, update_record, upsert_record, add_record_comment, update_record_status, update_record_assignees, get_record_comments), file operations (upload_file, download_file), app information (get_apps_info, get_form_layout, get_form_fields, get_app_actions, get_app_plugins, get_process_management, get_app_acl, get_field_acl, get_record_acl, evaluate_records_acl, get_views, get_reports, get_notifications, get_per_record_notifications, get_reminder_notifications), app operations (create_app, add_fields, update_field, update_form_layout, update_app_settings, deploy_app, get_deploy_status, move_app_to_space, move_app_from_space, update_app_acl, update_field_acl, update_views, update_reports, update_notifications, update_per_record_notifications, update_reminder_notifications, update_process_management, update_app_actions) and space/user/connection helpers (get_space, update_space, update_space_body, get_space_members, update_space_members, add_thread, update_thread, add_thread_comment, add_guests, update_space_guests, get_users, get_groups, get_group_users, get_kintone_domain, get_kintone_username). To start, ensure the environment variables for KINTONE_DOMAIN, KINTONE_USERNAME, and KINTONE_PASSWORD are set correctly, and that server.js is accessible at the specified path. The MCP tools can then be invoked from Claude Desktop or other MCP clients by selecting the kintone server and choosing the desired tool.

Prerequisites:

• Node.js 20 or later
• pnpm or npm
• Access to the kintone domain and credentials expressed as environment variables

Steps:

1. Obtain the source code or clone the repository that contains the MCP server (server.js). Ensure the project is in a path without spaces and ASCII-only if possible.
2. Install dependencies:

pnpm install

or

npm install

3. Prepare the Claude Desktop configuration (claude_desktop_config.json) by adding the MCP server entry similar to the following:

{
  "mcpServers": {
    "kintone": {
      "command": "node",
      "env": {
        "KINTONE_DOMAIN": "your-subdomain.cybozu.com",
        "KINTONE_USERNAME": "your-kintone-username",
        "KINTONE_PASSWORD": "your-kintone-password"
      },
      "args": [
        "path/to/server.js"
      ]
    }
  }
}

4. Start or run the MCP server via the configured entry. If you are using the provided Node.js script, you would typically run

node path/to/server.js

5. Restart Claude Desktop to reload the updated configuration, and ensure the extension shows the kintone MCP server as enabled and accessible. Open a new chat and select the kintone MCP server to begin using its tools.

Optional: If you are not using a mcpb file (Claude extension), you can manually wire your environment and ensure your server.js imports and exposes the MCP API according to MCP specifications.

Tips and notes:

• The README shows an unofficial kintone MCP server intended for local development and Claude Desktop integration. Use it with caution in production environments.
• Environment variables KINTONE_DOMAIN, KINTONE_USERNAME, KINTONE_PASSWORD are required for kintone connectivity. Store them securely and avoid hard-coding credentials.
• The server exposes a broad range of tools for kintone operations, including app and space management, user/group information, and per-record access controls. Review docs/tool-annotations.md for details on tool usage and annotations.
• If you install via mcpb for Claude Desktop, ensure the mcpb file contains the correct server path and credentials.
• If you encounter issues with large file downloads, consider using the upload_file and download_file tools with smaller payloads or adjust Kintone settings if applicable.
• The npm_package value is not clearly defined in this repository; if you publish an npm package for this MCP server, set the exact package name there. Otherwise, this field can be null.