README.md•3.11 kB
# MCP server for kintone
[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [kintone](https://www.kintone.com/).
This server allows you to explore and manipulate kintone data using AI tools such as [Claude Desktop](https://claude.ai/download)!
Japanese version: 日本語の説明は[README.ja.md](README.ja.md)にあります。
## 2025-08-28 ANNOUNCEMENT / お知らせ
Cybozu have released [the official kintone MCP server](https://github.com/kintone/mcp-server)! :tada:
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サーバー](https://cybozu.dev/ja/kintone/news/api-updates/2025-08-mcp/)をリリースしました！ :tada:
本プロジェクトの役割は果したと考えますので、今後は新規の機能追加は行いません。ただし、公式MCPサーバーが本MCPサーバーが持つ機能をカバーするまではメンテナンスは継続します。
ぜひ公式のMCPサーバーを利用してください！
## Usage
### 1. Install
Download the latest release from the [release page](https://github.com/macrat/mcp-server-kintone/releases).
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:
```json
{
"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."