MCP server for kintone sample

This is a sample code of Model Context Protocol (MCP) server that can be used for kintone integration. It was automatically created using generative AI and is provided as is.

Using this MCP server, you can view and update kintone data from MCP host apps such as the Claude Desktop app, and even create kintone apps themselves.

For more information about this repository, see the DeepWiki documentation .

How to use Claude Desktop app

1. Download the source code

You can download it to any location, but it's best to use a path that consists of alphanumeric characters only and has no spaces in between.

2. Install Node.js

Please use Node.js 18 or later.

3. npm install

npm i

4. Edit the Claude Desktop app configuration file

Find the configuration file called claude_desktop_config.json and add the settings to the "mcpServers" section of this file as shown below.

{
  "mcpServers": {
    "kintone": {
      "command": "node",
      "env": {
        "KINTONE_DOMAIN": "[あなたが使用するサブドメイン].cybozu.com",
        "KINTONE_USERNAME": "MCP接続で使用するkintoneユーザー名",
        "KINTONE_PASSWORD": "kintoneユーザーのパスワード（平文）"
      },
      "args": [
        "[kintone-mcp-serverを配置したパス]/server.js"
      ]
    }
  }
}

5. Restart the Claude Desktop app

After saving the changes to claude_desktop_config.json, quit the Claude Desktop app and restart it. Even if the app appears to have been quitted, it may still be running in the background, so right-click on the app icon and select Quit.

6. Operation check

First, ask Claude to "Find the app ID for the kintone app " An example of an app name that can be accessed by the kintone user you set ." The kintone app name you enter here must be specified exactly, word for word.

7. List of features provided by this MCP server

For annotation attributes for each tool, see docs/tool-annotations.md .

Record Operations

• get_record : Get a record from the kintone app

• search_records : Search for records in the kintone app

• create_record : Create a new record in the kintone app

• update_record : Update an existing record in the kintone app

• add_record_comment : Add a comment to a kintone record

File Operations

• upload_file : Upload a file to kintone

• download_file : Download a file from kintone (Note: In the current implementation, files over 1MB may not be downloaded correctly)

App Information

• get_apps_info : Get information on multiple kintone apps by specifying search keywords

• get_form_layout : Get the form layout of the kintone app

• get_app_actions : Gets the app action settings for the kintone app.

• get_app_plugins : Get a list of plugins added to the kintone app

• get_process_management : Get the process management settings of the kintone app

App operation

• create_app : Create a new kintone app

• add_fields : Add fields to the kintone app

• update_field : Update the settings of an existing kintone field

• update_form_layout : Change the form layout of the kintone app

• update_app_settings : Change general app settings

• deploy_app : Start of production operation of kintone app (reflected in the production environment)

• get_deploy_status : Check the status of application settings in the production environment

• move_app_to_space : Move the kintone app to the specified space

• move_app_from_space : Move the kintone app away from the space

Space Operations

• get_space : Get general information about a space

• update_space : Update space settings

• update_space_body : Update the space body

• get_space_members : Get the list of space members

• update_space_members : Update space members

• add_thread : Add a thread to a space

• update_thread : Update a thread

• add_thread_comment : Add a comment to a thread

• add_guests : Add guest users

• update_space_guests : Update space guest members

User Group Information

• get_users : Get kintone user information

• get_groups : Get kintone group information

• get_group_users : Gets a list of users belonging to a specified group

kintone connection information

• get_kintone_domain : Get the domain to which kintone is connected

• get_kintone_username : Gets the username used to connect to kintone

8. Other

I wrote a blog post about what you can do with this MCP server, so please take a look.

• The wonderful relationship between kintone and the generative AI (Claude)

• Current location of kintone AI Lab and kintone MCP Server

"kintone" is a registered trademark of Cybozu, Inc.

The contents described here are for informational purposes only, and we cannot provide individual support. Please note that we cannot respond to inquiries about the settings or if the software does not work in your environment.