Kintone MCP server for AI agents

The Model Context Protocol (MCP) server for kintone allows you to connect Claude Desktop and other MCP-compatible desktop applications to your kintone data. It enables AI assistants to seamlessly access, modify, and create kintone applications through a user-friendly interface optimized for LLM interaction.

Installation Options

Using the MCPB File (Recommended)

Download the latest unofficial-kintone-mcp-server-8.0.0.mcpb from the releases page.
Open Claude Desktop app and go to Settings > Desktop App > Extensions.
Either drag and drop the downloaded MCPB file into the designated area or click "Advanced Settings" followed by "Install Extension..." and select the file.
When prompted, enter your kintone connection details:
- Kintone domain
- Username
- Password
Save the configuration and toggle the switch to "Enabled".
Close the settings screen and open a new chat.
Click the tools icon to verify that "unofficial-kintone-mcp-server" appears in the list of available extensions.
You can click the ">" icon next to the extension name to see and optionally disable specific tools.

Manual Local Installation

Prerequisites

Node.js 20 or higher
pnpm or npm

Installation Steps

Download the source code to a path with no spaces and only alphanumeric characters.
Install dependencies:
```
pnpm install
```
or
```
npm install
```

Locate and edit your Claude Desktop config file (claude_desktop_config.json) to add the MCP server configuration:

{
  "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"
      ]
    }
  }
}

Completely exit and restart the Claude Desktop app (make sure to quit from the system tray if needed).

Usage

Getting Started

To verify the installation is working correctly, ask Claude a question like: "Look up the app ID for the kintone app named '[name of an app you have access to]'". Make sure to use the exact name of the kintone app.

Available Tools

The MCP server provides numerous tools organized into several categories:

Record Operations

get_record: Retrieve a single record
search_records: Search for records matching criteria
create_record: Create a new record
update_record: Update an existing record
upsert_record: Create or update a record using a unique field
add_record_comment: Add comments to a record
update_record_status: Update a record's process status
update_record_assignees: Update record assignees
get_record_comments: Get comments on a record
update_record_comment: Update an existing comment

File Operations

upload_file: Upload files to kintone
download_file: Download files from kintone (Note: May have issues with files larger than 1MB)

App Information

get_apps_info: Find app information using name, ID, or other criteria
get_form_layout: Get the form layout configuration
get_form_fields: Get field definitions for an app
get_app_actions: Retrieve app action settings
get_app_plugins: List plugins added to an app
get_process_management: Get process management settings
And many more tools for accessing views, reports, notifications, and permissions

App Management

create_app: Create a new kintone app
add_fields: Add fields to an app
update_field: Update an existing field's settings
update_form_layout: Modify form layout
deploy_app: Deploy app changes to production
And many more tools for managing app settings and configurations

Space Operations

Various tools for managing kintone spaces, threads, and guests

User and Group Information

Tools for retrieving user and group data

Connection Information

get_kintone_domain: Get the connected kintone domain
get_kintone_username: Get the username used for connection

For detailed information about tool parameters and usage, consult the official documentation.

AI: The Model Context Protocol (MCP) server for kintone allows you to connect Claude Desktop and other MCP-compatible desktop applications to your kintone data. It enables AI assistants to seamlessly access, modify, and create kintone applications through a user-friendly interface optimized for LLM interaction.

Installation Options

Using the MCPB File (Recommended)

Download the latest unofficial-kintone-mcp-server-8.0.0.mcpb from the releases page on GitHub.
Open Claude Desktop app and go to Settings > Desktop App > Extensions.
Either drag and drop the downloaded MCPB file into the designated area or click "Advanced Settings" followed by "Install Extension..." and select the file.
When prompted, enter your kintone connection details:
- Kintone domain
- Username
- Password
Save the configuration and toggle the switch to "Enabled".
Close the settings screen and open a new chat.
Click the tools icon to verify that "unofficial-kintone-mcp-server" appears in the list of available extensions.
You can click the ">" icon next to the extension name to see and optionally disable specific tools.

Manual Local Installation

Prerequisites

Node.js 20 or higher
pnpm or npm

Installation Steps

Download the source code to a path with no spaces and only alphanumeric characters.
Install dependencies:
```
pnpm install
```
or
```
npm install
```

Locate and edit your Claude Desktop config file (claude_desktop_config.json) to add the MCP server configuration:

{
  "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"
      ]
    }
  }
}

Completely exit and restart the Claude Desktop app (make sure to quit from the system tray if needed).

Usage

Getting Started

Available Tools

The MCP server provides numerous tools organized into several categories:

Record Operations

get_record: Retrieve a single record
search_records: Search for records matching criteria
create_record: Create a new record
update_record: Update an existing record
upsert_record: Create or update a record using a unique field
add_record_comment: Add comments to a record
update_record_status: Update a record's process status
update_record_assignees: Update record assignees
get_record_comments: Get comments on a record
update_record_comment: Update an existing comment

File Operations

upload_file: Upload files to kintone
download_file: Download files from kintone (Note: May have issues with files larger than 1MB)

App Information

get_apps_info: Find app information using name, ID, or other criteria
get_form_layout: Get the form layout configuration
get_form_fields: Get field definitions for an app
get_app_actions: Retrieve app action settings
get_app_plugins: List plugins added to an app
get_process_management: Get process management settings
And many more tools for accessing views, reports, notifications, and permissions

App Management

create_app: Create a new kintone app
add_fields: Add fields to an app
update_field: Update an existing field's settings
update_form_layout: Modify form layout
deploy_app: Deploy app changes to production
And many more tools for managing app settings and configurations

Space Operations

Various tools for managing kintone spaces, threads, and guests

User and Group Information

Tools for retrieving user and group data

Connection Information

get_kintone_domain: Get the connected kintone domain
get_kintone_username: Get the username used for connection

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