Kintone MCP server for AI agents

This MCP server allows you to interact with kintone through AI applications that support the Model Context Protocol (MCP). With this tool, you can query and update kintone data, create new kintone applications, and perform various operations directly from MCP host applications like Claude Desktop.

Installation

Installing via .dxt File (Recommended)

Download the latest kintone-mcp-server.dxt file from the releases page and install it in the Claude Desktop app:

Download the latest kintone-mcp-server.dxt file from releases
Open the Claude Desktop app
Go to Settings > Extensions
Drag and drop the .dxt file into the extensions screen
Enter your kintone domain name, username, and password
Click "Save"
Confirm the extension status shows as "Enabled"

Manual Installation

If you prefer not to use the .dxt file, follow these steps:

Download the source code to a directory path containing only alphanumeric characters (no spaces)
Install Node.js (version 20 or later)
Install dependencies:
```
npm i
```

Edit the Claude Desktop config file: Find the claude_desktop_config.json file and add the following to the "mcpServers" section:

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

Restart the Claude Desktop app Make sure to completely quit the app (including from the system tray) before restarting

Usage

Verifying Setup

To check if the MCP server is working correctly, ask Claude: "What is the app ID of the kintone app '[name of an app you can access]'?"

Note that you must specify the kintone app name exactly as it appears in your kintone environment.

Available Features

Record Operations

get_record: Retrieve a single record from a kintone app
search_records: Search for records in a kintone app
create_record: Create a new record in a kintone app
update_record: Update an existing record in a kintone app
upsert_record: Create or update a record based on a unique field
add_record_comment: Add a comment to a kintone record
update_record_status: Update the status of a record (process management)
update_record_assignees: Update the assignees of a record (process management)
get_record_comments: Get comments from a kintone record
update_record_comment: Update an existing comment on a kintone record

File Operations

upload_file: Upload a file to kintone
download_file: Download a file from kintone (note: files larger than 1MB may not download properly)

App Information

get_apps_info: Get information about multiple kintone apps based on search keywords
get_form_layout: Get the form layout of a kintone app
get_app_actions: Get the app action settings of a kintone app
get_app_plugins: Get a list of plugins added to a kintone app
get_process_management: Get the process management settings of a kintone app
get_app_acl: Get the access permissions of a kintone app
get_field_acl: Get the field access permissions of a kintone app
get_record_acl: Get the access permissions of a specific record
evaluate_records_acl: Evaluate record access permissions based on specified conditions
get_views: Get the view settings of a kintone app
get_reports: Get the graph settings of a kintone app
get_notifications: Get the notification settings of a kintone app
get_per_record_notifications: Get the per-record notification settings of a kintone app
get_reminder_notifications: Get the reminder notification settings of a kintone app

App Operations

create_app: Create a new kintone app
add_fields: Add fields to a kintone app
update_field: Update the settings of an existing kintone field
update_form_layout: Change the form layout of a kintone app
update_app_settings: Change the general settings of an app
deploy_app: Deploy a kintone app to the production environment
get_deploy_status: Check the deployment status of app settings
move_app_to_space: Move a kintone app to a specified space
move_app_from_space: Remove a kintone app from a space
update_app_acl: Update the access permissions of a kintone app
update_field_acl: Update the field access permissions of a kintone app
update_views: Update the view settings of a kintone app
update_reports: Update the graph settings of a kintone app
update_notifications: Update the notification settings of a kintone app
update_per_record_notifications: Update the per-record notification settings of a kintone app
update_reminder_notifications: Update the reminder notification settings of a kintone app
update_process_management: Update the process management settings of a kintone app
update_app_actions: Update the action settings of a kintone app

Space Operations

get_space: Get general information about a space
update_space: Update space settings
update_space_body: Update the content of a space
get_space_members: Get a 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 guest members of a space

User and Group Information

get_users: Get kintone user information
get_groups: Get kintone group information
get_group_users: Get a list of users belonging to a specified group

kintone Connection Information

get_kintone_domain: Get the connected kintone domain
get_kintone_username: Get the username used to connect to kintone

For more information about what you can do with this MCP server, check out these blog posts:

A separate OAuth-supported remote MCP server that can be used from the web browser version of Claude is available here.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "kintone" '{"command":"node","env":{"KINTONE_DOMAIN":"[\u3042\u306a\u305f\u304c\u4f7f\u7528\u3059\u308b\u30b5\u30d6\u30c9\u30e1\u30a4\u30f3].cybozu.com","KINTONE_USERNAME":"MCP\u63a5\u7d9a\u3067\u4f7f\u7528\u3059\u308bkintone\u30e6\u30fc\u30b6\u30fc\u540d","KINTONE_PASSWORD":"kintone\u30e6\u30fc\u30b6\u30fc\u306e\u30d1\u30b9\u30ef\u30fc\u30c9\uff08\u5e73\u6587\uff09"},"args":["[kintone-mcp-server\u3092\u914d\u7f6e\u3057\u305f\u30d1\u30b9]/server.js"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "kintone": {
            "command": "node",
            "env": {
                "KINTONE_DOMAIN": "[\u3042\u306a\u305f\u304c\u4f7f\u7528\u3059\u308b\u30b5\u30d6\u30c9\u30e1\u30a4\u30f3].cybozu.com",
                "KINTONE_USERNAME": "MCP\u63a5\u7d9a\u3067\u4f7f\u7528\u3059\u308bkintone\u30e6\u30fc\u30b6\u30fc\u540d",
                "KINTONE_PASSWORD": "kintone\u30e6\u30fc\u30b6\u30fc\u306e\u30d1\u30b9\u30ef\u30fc\u30c9\uff08\u5e73\u6587\uff09"
            },
            "args": [
                "[kintone-mcp-server\u3092\u914d\u7f6e\u3057\u305f\u30d1\u30b9]/server.js"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "kintone": {
            "command": "node",
            "env": {
                "KINTONE_DOMAIN": "[\u3042\u306a\u305f\u304c\u4f7f\u7528\u3059\u308b\u30b5\u30d6\u30c9\u30e1\u30a4\u30f3].cybozu.com",
                "KINTONE_USERNAME": "MCP\u63a5\u7d9a\u3067\u4f7f\u7528\u3059\u308bkintone\u30e6\u30fc\u30b6\u30fc\u540d",
                "KINTONE_PASSWORD": "kintone\u30e6\u30fc\u30b6\u30fc\u306e\u30d1\u30b9\u30ef\u30fc\u30c9\uff08\u5e73\u6587\uff09"
            },
            "args": [
                "[kintone-mcp-server\u3092\u914d\u7f6e\u3057\u305f\u30d1\u30b9]/server.js"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect