Kintone MCP Server

How to use

To use this MCP server with an MCP client, first start the local server process and connect the client to it. You will configure the client to point at the local MCP server, supply your kintone credentials, and enable the unofficial kintone MCP server extension. Once connected, you can perform common kintone operations such as retrieving records, creating and updating records, managing apps and forms, handling files, and adjusting app permissions through the MCP client’s interface.

How to install

Prerequisites and installation flow differ slightly depending on whether you use the MCP file based installer or a local runtime setup.

# If you are using the MCP file (mcpb) installer, follow the client instructions to add the extension in Claude Desktop.
# If you are installing locally without the MCPB, proceed with the steps below.

Additional content (local runtime with npm/yarn)

If you choose the local runtime approach, ensure Node.js 20 or later is installed, along with a package manager such as pnpm or npm. Then do the following to set up the server locally and connect it to Claude Desktop or another MCP host.

pnpm install
# or
npm install

Configure Claude Desktop to connect to the kintone MCP server

Create or edit the Claude Desktop configuration to define an MCP server entry that runs the MCP server locally. Use the following example as a template. It shows how to set the required environment variables for kintone and the path to the server script.

{
  "mcpServers": {
    "kintone": {
      "command": "node",
      "env": {
        "KINTONE_DOMAIN": "[your-subdomain].cybozu.com",
        "KINTONE_USERNAME": "MCP user name for kintone connection",
        "KINTONE_PASSWORD": "password for the kintone user (plain text)"
      },
      "args": [
        "[path-to-kintone-mcp-server]/server.js"
      ]
    }
  }
}

Enable and use the MCP server in the client

After saving the configuration, enable the kintone MCP server entry and restart the Claude Desktop client if needed. Open a new chat and access the tool panel to verify that the unofficial-kintone-mcp-server is loaded and available. If multiple tools are shown, you can disable any you do not want to use.

Using the MCP server tools

The MCP server provides a set of tools to perform operations across kintone apps, spaces, records, files, and users. You can enable or disable specific tools in the client interface to control what actions you want available in your session.

get_record

Retrieve a single record from a specified kintone app by ID.

search_records

Search records in a kintone app using filters and query parameters.

create_record

Create a new record in a kintone app with the provided field values.

update_record

Update fields of an existing record in a kintone app.

upsert_record

Create or update a record based on a specified unique field (upsert behavior).

add_record_comment

Add a comment to a specific kintone record.

update_record_status

Update the status of a record to manage workflow processes.

update_record_assignees

Assign or reassign users to a record for workflow tracking.

get_record_comments

Fetch comments associated with a specific record.

upload_file

Upload a file to kintone and associate it with a record.

download_file

Download a file from kintone (note: large files may have limitations).

get_apps_info

Retrieve information about apps including name, ID, code, and space.

get_form_layout

Obtain the form layout of a kintone app.

get_form_fields

Get form field information for a kintone app (production environment).

get_app_actions

Fetch app action configurations.

get_app_plugins

List plugins installed on a kintone app.

get_process_management

Retrieve process management settings for an app.

get_app_acl

Get access control lists for an app.

get_field_acl

Get access control for fields within an app.

get_record_acl

Get access control for a specific record.

evaluate_records_acl

Evaluate access control for records based on given conditions.

get_views

Retrieve app views (list of views) for an app.

get_reports

Get graph/report configurations for an app.

get_notifications

Get notification conditions for an app.

get_per_record_notifications

Fetch per-record notification settings for an app.

get_reminder_notifications

Get reminder notification settings for an app.

create_app

Create a new kintone app.

add_fields

Add fields to an existing app.

update_field

Update a specific field in an app.

update_form_layout

Update the form layout of an app.

update_app_settings

Change general app settings.

deploy_app

Deploy app changes to the live environment.

get_deploy_status

Check deployment status for app changes.

move_app_to_space

Move an app to a specified space.

move_app_from_space

Detach an app from its space.

update_app_acl

Update app-level access control lists.

update_field_acl

Update field-level access control lists.

update_views

Update app views.

update_reports

Update app graph/report configurations.

update_notifications

Update app notification conditions.

update_per_record_notifications

Update per-record notification settings.

update_reminder_notifications

Update reminder notification settings.

update_process_management

Update process management settings for an app.

update_app_actions

Update app action configurations.

get_space

Get information about a kintone space.

update_space

Update space settings.

update_space_body

Update the body/content of a space.

get_space_members

List members of a space.

update_space_members

Update space member list.

add_thread

Add a thread to a space.

update_thread

Update a space thread.

add_thread_comment

Add a comment to a space thread.

add_guests

Add guest users to a space.

update_space_guests

Update space guest members.

get_users

Retrieve kintone user information.

get_groups

Retrieve kintone group information.

get_group_users

List users in a specified group.

get_kintone_domain

Get the kintone connection domain.

get_kintone_username

Get the username used for kintone connection.