Kintone Mcp Server
About
An official local MCP (Model Context Protocol) server for kintone, enabling AI assistants to interact with kintone apps, records, spaces, and settings via a set of tools.
Details
- Author
- kintone
- GitHub stars
- 50
- Downloads
- 326
- Categories
- Other
Jump to
- Manage kintone apps: get, create, deploy, update fields and layouts.
- Record operations: get, add, update, delete records and statuses.
- Comment handling: get and add comments on records.
- File attachment download: save files to a specified directory.
- Space management: create, update, and get space information.
- Support for password, API token, and client certificate authentication.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Kintone Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via MCPB (Claude Desktop extension), Docker container, or npm package. Configure with command-line arguments or environment variables: KINTONE_BASE_URL, KINTONE_USERNAME/KINTONE_PASSWORD or KINTONE_API_TOKEN, and optional KINTONE_BASIC_AUTH_USERNAME, KINTONE_BASIC_AUTH_PASSWORD, KINTONE_PFX_FILE_PATH, KINTONE_PFX_FILE_PASSWORD, HTTPS_PROXY, KINTONE_ATTACHMENTS_DIR. Use in AI tools like Claude Code or Cursor by referencing a JSON configuration file (e.g., .mcp.json or .cursor/mcp.json).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"kintone mcp server": {
"kintone": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KINTONE_BASE_URL",
"-e",
"KINTONE_USERNAME",
"-e",
"KINTONE_PASSWORD",
"ghcr.io/kintone/mcp-server:latest"
],
"cwd": "${cwd}",
"env": {
"KINTONE_BASE_URL": "https://example.cybozu.com",
"KINTONE_USERNAME": "username",
"KINTONE_PASSWORD": "password"
}
}
}
}
}McpServers
{
"kintone": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KINTONE_BASE_URL",
"-e",
"KINTONE_USERNAME",
"-e",
"KINTONE_PASSWORD",
"ghcr.io/kintone/mcp-server:latest"
],
"cwd": "${cwd}",
"env": {
"KINTONE_BASE_URL": "https://example.cybozu.com",
"KINTONE_USERNAME": "username",
"KINTONE_PASSWORD": "password"
}
}
}kintone MCP Server
[![ci][ci-badge]][ci-url]
[![npm version][npm-badge]][npm-url]
[![License: MIT][license-badge]][license-url]
[![Install MCP Server][cursor-badge]][cursor-url]
[ci-badge]: https://github.com/kintone/mcp-server/actions/workflows/ci.yaml/badge.svg
[ci-url]: https://github.com/kintone/mcp-server/actions/workflows/ci.yaml
[npm-badge]: https://badge.fury.io/js/@kintone%2Fmcp-server.svg?icon=si%3Anpm
[npm-url]: https://badge.fury.io/js/@kintone%2Fmcp-server
[license-badge]: https://img.shields.io/badge/License-Apache_2.0-blue.svg
[license-url]: LICENSE
[cursor-badge]: https://cursor.com/deeplink/mcp-install-dark.svg
[cursor-url]: https://cursor.com/en/install-mcp?name=kintone&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiZW52Ijp7IktJTlRPTkVfQkFTRV9VUkwiOiJodHRwczovLyhzdWJkb21haW4pLmN5Ym96dS5jb20iLCJLSU5UT05FX1VTRVJOQU1FIjoiKHVzZXJuYW1lKSIsIktJTlRPTkVfUEFTU1dPUkQiOiIocGFzc3dvcmQpIn0sImFyZ3MiOlsicnVuIiwiLWkiLCItLXJtIiwiLWUiLCJLSU5UT05FX0JBU0VfVVJMIiwiLWUiLCJLSU5UT05FX1VTRVJOQU1FIiwiLWUiLCJLSU5UT05FX1BBU1NXT1JEIiwiZ2hjci5pby9raW50b25lL21jcC1zZXJ2ZXI6bGF0ZXN0Il19
<!--
NOTE: Cursorのインストールリンク生成は pnpm doc:cursor-install-link で生成している
-->
日本語 | English
kintoneの公式ローカルMCPサーバーです。
<!-- NOTE: TOCはpnpm doc:update-tocで自動生成されます。 -->
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
- インストール
- MCPB (Claude Desktop用パッケージ)
- Dockerコンテナイメージ
- npmパッケージ
- 利用方法
- 設定ファイルのパスの例
- 設定ファイルの内容の例
- 設定
- 設定オプション一覧
- プロキシ設定
- ツール一覧
- ドキュメント
- 使用上の注意
- kintone-download-fileツールの注意点
- 制限事項
- レコード操作の制限
- その他の制限
- トラブルシューティング
- 接続エラーになる場合
- 認証エラーになる場合
- 権限エラーになる場合
- サポート方針
- コントリビューション
- プライバシー
- ライセンス
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
インストール
MCPB (Claude Desktop用パッケージ)
MCPBファイルは、Claude Desktopの拡張機能としてインストールできます。
以下の手順でインストールしてください。
1. リリース一覧 にアクセス
2. 最新のリリースから kintone-mcp-server.mcpb をダウンロード
3. Claude Desktopを開く
4. 設定から「デスクトップアプリ」→「拡張機能」のページを開く
5. ダウンロードした kintone-mcp-server.mcpb をClaude Desktopの画面にドラッグ＆ドロップ
6. インストール確認ダイアログが表示されるので「インストール」を選択
7. 設定ダイアログが表示されるので、必要な情報を入力する
- Kintone Base URL: kintoneのベースURL (例: https://example.cybozu.com)
- Kintone Username: kintoneのユーザー名
- Kintone Password: kintoneのパスワード
Dockerコンテナイメージ
Dockerのインストールが必要です。
以下のコマンドでコンテナを起動できます。
docker run -i --rm \
-e KINTONE_BASE_URL=https://example.cybozu.com \
-e KINTONE_USERNAME=(username) \
-e KINTONE_PASSWORD=(password) \
ghcr.io/kintone/mcp-server
npmパッケージ
Node.jsのインストールが必要です。
以下のコマンドでインストールできます。
npm install -g @kintone/mcp-server
以下のコマンドでサーバーを起動できます。
```shell
kintone-mcp-server \
--base-url https://example.cybozu.com \
--username (username) \
--password (password)
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
