MCP server for kintone sample

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

Using this MCP server, you can access and update kintone data from the Claude Desktop app.

If you want to use the Claude desktop app as a client, you need a subscription to the Claude Pro plan, which can also be used with Windsurf and CLINE.

How to use

1. Download the source code

You can download it to anywhere, 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

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.

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's 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

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 : Get the username used to connect to kintone

8. Other

I have also written a blog post about what you can do with this MCP server, so please read it.

There are other people who have released MCP servers for kintone, so it might be a good idea to use them as a reference and create your own original 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.