Kintone

Kintone MCP lets you use Kintone app records, fields, comments, file attachments, and process management information in AIP chat and agents. You can ask in natural language to retrieve business data, update records, handle attachments, and check approval flows.

Key Features

View Kintone app lists and app information.
Check app field codes, field types, and form layouts.
Retrieve, create, update, and delete records.
View record comments or add new comments.
Upload files to Kintone or download Kintone files as AIP files.
Check process management statuses and actions, and update record statuses.

Before You Start

To connect Kintone MCP, prepare the following information.

Kintone OAuth Client
Kintone Base URL
Client ID
Client Secret
Permissions to access the Kintone apps and records you want to integrate

When creating an OAuth Client in Kintone, register the Callback URL shown in AIP in the Kintone OAuth Client settings.

Setup

Step 1: Add MCP Integration

Select Kintone from the MCP Integrations menu.

Step 2: Enter OAuth Client Information

Enter the Kintone Base URL, Client ID, and Client Secret.

Step 3: Authenticate with Kintone

After saving the integration, authenticate with your Kintone account. Once authentication is complete, AIP can access Kintone apps and records.

Step 4: Use in Chat or Agents

In chat or an agent, ask in natural language with the Kintone app name, record conditions, and the task you want to perform.

Supported MCP Tools

App and Schema Tools

list_apps

Search or view the list of Kintone apps.

get_app

Retrieve basic information for a Kintone app by app ID.

get_form_fields

Retrieve app field codes, types, labels, options, Lookup, Subtable, and file field information.

get_form_layout

Retrieve the app form layout.

get_general_settings

Retrieve general settings such as app name, description, icon, theme, and title field.

Record Management Tools

get_record

Retrieve a single record by record ID.

get_records

Retrieve a list of records with Kintone query conditions.

add_records

Create records.

update_records

Update records by record ID or updateKey.

delete_records

Delete records.

Process Management Tools

get_process_management

Retrieve process management statuses, actions, and assignee rules.

update_statuses

Run process management actions to change record statuses.

update_assignees

Change assignees for the current process status.

Comment Tools

get_comments

Retrieve a record’s comments.

add_comment

Add a comment to a record.

File Tools

upload_file

Upload an AIP file to Kintone and return the file key.

attach_files_to_record

Upload AIP files to Kintone and attach them to a record’s file field.

download_file

Download a Kintone attachment as an AIP file.

App Builder Tools

add_app

Create a Kintone app.

add_form_fields

Add fields to an app’s form settings.

update_form_fields

Update app field settings.

delete_form_fields

Delete app field settings.

update_form_layout

Update the app form layout.

update_general_settings

Update app general settings.

deploy_app

Apply or revert app setting changes to the production app.

get_app_deploy_status

Retrieve app setting deployment status.

Usage Examples

“Summarize deals registered this month in the Kintone sales management app.”
“Find unprocessed records in the customer inquiry app and organize them by assignee.”
“Leave this analysis result as a comment on the Kintone record.”
“Download the Kintone attachment and summarize its contents.”

Notes

Creating, updating, deleting records, and changing process status can directly affect Kintone data. Check the target app and conditions before running these actions.
Adding attachments requires Kintone file field permissions and app permissions.
Tasks may fail if Kintone permissions are insufficient or OAuth authentication has expired. In that case, check the authentication status in MCP Integration and re-authenticate.

Troubleshooting

Symptom	Cause	Solution
Kintone authentication fails	The Callback URL is not registered in the Kintone OAuth Client, or the Client information is incorrect	Check the Callback URL, Client ID, and Client Secret in the Kintone OAuth Client
Records cannot be found	You do not have app permissions, or the field code in the search condition is incorrect	Check Kintone app access permissions and field codes, then try again
File upload or download fails	You do not have file field permissions, or you cannot access the target record	Check Kintone app and record permissions, and file field settings

MCP Server Integration: View the list of MCP integrations available in AIP.
Agent User Guide: Connect Kintone MCP to an agent to automate repetitive work.