MCP server for kintone

Model Context Protocol (MCP) server for kintone. This server allows you to explore and manipulate kintone data using AI tools such as Claude Desktop!

Japanese version: 日本語の説明はREADME.ja.mdにあります。

2025-08-28 ANNOUNCEMENT / お知らせ

Cybozu have released the official kintone MCP server! 🎉
I believe this project's role has archieved, so I won't add any new features. Maintenance will still active until the official one has got enough functionalities. Please use and contribute to the official MCP server!

サイボウズが公式のkintone MCPサーバーをリリースしました！ 🎉
本プロジェクトの役割は果したと考えますので、今後は新規の機能追加は行いません。ただし、公式MCPサーバーが本MCPサーバーが持つ機能をカバーするまではメンテナンスは継続します。ぜひ公式のMCPサーバーを利用してください！

Usage

1. Install

Download the latest release from the release page. You can place the executable file anywhere you like.

2. Configure MCP client like Claude Desktop

Configure your client to connect to the server.

For Claude Desktop, please edit file below:

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

Add the following configuration to the mcpServers section:

{
  "mcpServers": {
    "kintone": {
      "command": "C:\\path\\to\\mcp-server-kintone.exe",
      "env": {
        "KINTONE_BASE_URL": "https://<domain>.cybozu.com",
        "KINTONE_USERNAME": "<your username>",
        "KINTONE_PASSWORD": "<your password>",
        "KINTONE_API_TOKEN": "<your api token>, <another api token>, ...",
        "KINTONE_ALLOW_APPS": "1, 2, 3, ...",
        "KINTONE_DENY_APPS": "4, 5, ..."
      }
    }
  }
}

Environment variables:

KINTONE_BASE_URL: (Required) The base URL of your kintone.
KINTONE_USERNAME: Your username for kintone.
KINTONE_PASSWORD: Your password for kintone.
KINTONE_API_TOKEN: Comma separated API token for kintone. You need to set either KINTONE_USERNAME and KINTONE_PASSWORD or KINTONE_API_TOKEN.
KINTONE_ALLOW_APPS: A comma-separated list of app IDs that you want to allow access. In default, all apps are allowed.
KINTONE_DENY_APPS: A comma-separated list of app IDs that you want to deny access. The deny has a higher priority than the allow.

You may need to restart Claude Desktop to apply the changes.

3. Start to use

Now you can interact with kintone using your own AI tools!

For example, you can say:

"What is the latest status of Customer A's project?"
"Update the progress of Project B to 50%."
"Show me the projects that are behind schedule."

2025-08-28 ANNOUNCEMENT / お知らせ

Usage

1. Install

Download the latest release from the release page. You can place the executable file anywhere you like.

2. Configure MCP client like Claude Desktop

Configure your client to connect to the server.

For Claude Desktop, please edit file below:

MacOS/Linux: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration to the mcpServers section:

{ "mcpServers": { "kintone": { "command": "C:\\path\\to\\mcp-server-kintone.exe", "env": { "KINTONE_BASE_URL": "https://<domain>.cybozu.com", "KINTONE_USERNAME": "<your username>", "KINTONE_PASSWORD": "<your password>", "KINTONE_API_TOKEN": "<your api token>, <another api token>, ...", "KINTONE_ALLOW_APPS": "1, 2, 3, ...", "KINTONE_DENY_APPS": "4, 5, ..." } } } }

Environment variables:

KINTONE_BASE_URL: (Required) The base URL of your kintone.

KINTONE_USERNAME: Your username for kintone.

KINTONE_PASSWORD: Your password for kintone.

KINTONE_API_TOKEN: Comma separated API token for kintone. You need to set either KINTONE_USERNAME and KINTONE_PASSWORD or KINTONE_API_TOKEN.

KINTONE_ALLOW_APPS: A comma-separated list of app IDs that you want to allow access. In default, all apps are allowed.

KINTONE_DENY_APPS: A comma-separated list of app IDs that you want to deny access. The deny has a higher priority than the allow.

You may need to restart Claude Desktop to apply the changes.

3. Start to use

Now you can interact with kintone using your own AI tools!

For example, you can say:

"What is the latest status of Customer A's project?"

"Update the progress of Project B to 50%."

"Show me the projects that are behind schedule."