Lets an AI client interact with kintone to manage applications, records, form layouts, and files through the official REST API.
Also known as kintone/mcp-server, @kintone/mcp-server
- Stars
- 59
- Tools
- —
- Downloads, 30 days
- 9,054
- Latest version
- —
- Last commit
- Nov 13, 2026
- License
- Apache-2.0
What is kintone MCP?
kintone lets an AI client interact with kintone to manage applications, records, form layouts, and files through the official REST API.
Summary generated from the project's README
About kintone MCP server
Managing kintone applications and data through an AI client is possible with this official local MCP server. It allows developers to interact with the kintone REST API to handle records, form layouts, and files. Users can set up the server locally using an npm package, a Docker container, or a dedicated Claude Desktop package.
To connect, you must provide a kintone base URL and authenticate using either a username and password or an API token. The server supports advanced configurations like client certificate authentication via PFX files and proxy settings for corporate environments. It provides specific tools for various tasks, such as kintone-get-records for data retrieval, kintone-update-form-fields for modifying layouts, and kintone-download-file for saving attachments to a local directory. Note that the server cannot access apps within guest spaces.
Written from the project's README. Every use case is checked against a quote from it.
How to install kintone MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall kintone MCP in Claude Code
$ claude mcp add mcp-server -- npx -y @kintone/mcp-serverInstall kintone MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@kintone/mcp-server"
]
}
}
}Install kintone MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kintone/mcp-server"
]
}
}
}Install kintone MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@kintone/mcp-server"]}'Install kintone MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@kintone/mcp-server"
]
}
}
}Install kintone MCP in Codex
$ codex mcp add mcp-server -- npx -y @kintone/mcp-serverInstall kintone MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@kintone/mcp-server"]
Install kintone MCP in Gemini CLI
$ gemini mcp add -s user mcp-server npx -- -y @kintone/mcp-serverInstall kintone MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@kintone/mcp-server"
]
}
}
}Configuration
KINTONE_BASE_URLKINTONE_PASSWORDKINTONE_USERNAME
| Name | Description | |
|---|---|---|
| KINTONE_BASE_URL | — | |
| KINTONE_PASSWORD | — | |
| KINTONE_USERNAME | — |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubkintone MCP Server
日本語 | English
kintoneの公式ローカルMCPサーバーです。
インストール
MCPB (Claude Desktop用パッケージ)
MCPBファイルは、Claude Desktopの拡張機能としてインストールできます。
以下の手順でインストールしてください。
- リリース一覧 にアクセス
- 最新のリリースから
kintone-mcp-server.mcpbをダウンロード - Claude Desktopを開く
- 設定から「デスクトップアプリ」→「拡張機能」のページを開く
- ダウンロードした
kintone-mcp-server.mcpbをClaude Desktopの画面にドラッグ&ドロップ - インストール確認ダイアログが表示されるので「インストール」を選択
- 設定ダイアログが表示されるので、必要な情報を入力する
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
以下のコマンドでサーバーを起動できます。
kintone-mcp-server \
--base-url https://example.cybozu.com \
--username (username) \
--password (password)
# `--base-url`、`--username`、`--password` は
# 環境変数 `KINTONE_BASE_URL`、`KINTONE_USERNAME`、`KINTONE_PASSWORD` でも指定可能です。
利用方法
MCPBファイルをインストールした場合、追加の手順は必要ありません。
その他の利用方法では、設定ファイルを作成する必要があります。 設定ファイルの作成方法の詳細は、利用するAIツールのドキュメントを参照してください。
設定ファイルのパスの例
設定ファイルの内容の例
{
"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"
}
}
}
}
設定
設定オプション一覧
| コマンドライン引数 | 環境変数 | 説明 | 必須 |
|---|---|---|---|
--base-url |
KINTONE_BASE_URL |
kintone環境のベースURL(例: https://example.cybozu.com) |
✓ |
--username |
KINTONE_USERNAME |
kintoneのログインユーザー名 | ※1 |
--password |
KINTONE_PASSWORD |
kintoneのログインパスワード | ※1 |
--api-token |
KINTONE_API_TOKEN |
APIトークン(カンマ区切りで最大9個まで指定可能) | ※1 |
--basic-auth-username |
KINTONE_BASIC_AUTH_USERNAME |
Basic認証のユーザー名 | - |
--basic-auth-password |
KINTONE_BASIC_AUTH_PASSWORD |
Basic認証のパスワード | - |
--pfx-file-path |
KINTONE_PFX_FILE_PATH |
PFXファイルのパス(クライアント証明書認証用) | - |
--pfx-file-password |
KINTONE_PFX_FILE_PASSWORD |
PFXファイルのパスワード | - |
--proxy |
HTTPS_PROXY |
HTTPSプロキシのURL(例: http://proxy.example.com:8080) |
- |
--attachments-dir |
KINTONE_ATTACHMENTS_DIR |
ダウンロードしたファイルの保存先 | - |
※1: KINTONE_USERNAME & KINTONE_PASSWORD または KINTONE_API_TOKEN のいずれかが必須
注意事項:
- クライアント証明書認証を使用する場合、URLのドメインは
.s.cybozu.comとなります(例:https://example.s.cybozu.com) - パスワード認証とAPIトークン認証を同時に指定した場合、パスワード認証が優先されます
- コマンドライン引数と環境変数を同時に指定した場合、コマンドライン引数が優先されます
- 詳細な認証設定については 認証設定ガイド を参照してください
プロキシ設定
企業環境などでプロキシサーバーを経由する必要がある場合は、HTTPS_PROXY 環境変数を設定してください。
export HTTPS_PROXY="http://proxy.example.com:8080"
# 認証が必要な場合
export HTTPS_PROXY="http://username:password@proxy.example.com:8080"
ツール一覧
| ツール名 | 説明 |
|---|---|
kintone-get-apps |
複数のアプリ情報を取得 |
kintone-get-app |
単一アプリの詳細情報を取得 |
kintone-get-form-fields |
アプリのフィールド設定を取得 |
kintone-get-form-layout |
アプリのフォームレイアウトを取得 |
kintone-update-form-fields |
アプリのフィールド設定を更新 |
kintone-update-form-layout |
アプリのフォームレイアウトを更新 |
kintone-delete-form-fields |
アプリのフィールドを削除 |
kintone-get-process-management |
プロセス管理設定を取得 |
kintone-get-app-deploy-status |
アプリ設定の運用環境への反映状況確認 |
kintone-get-general-settings |
アプリの一般設定を取得 |
kintone-get-customization |
JavaScript / CSSカスタマイズ設定を取得 |
kintone-add-form-fields |
アプリにフィールドを追加 |
kintone-get-records |
複数のレコードを取得 |
kintone-add-records |
複数のレコードを追加 |
kintone-update-records |
複数のレコードを更新 |
kintone-delete-records |
複数のレコードを削除 |
kintone-update-statuses |
複数のレコードのステータスを更新 |
kintone-get-record-comments |
レコードのコメントを取得 |
kintone-add-record-comment |
レコードにコメントを追加 |
kintone-add-app |
動作テスト環境にアプリを作成 |
kintone-deploy-app |
アプリ設定を運用環境へ反映 |
kintone-update-general-settings |
アプリの一般設定を変更 |
kintone-download-file |
添付ファイルフィールドのファイルを保存 |
kintone-add-space-from-template |
テンプレートからスペースを作成 |
kintone-update-space |
スペースの設定を更新 |
kintone-get-space |
スペースの情報を取得 |
kintone-delete-space |
スペースを削除 |
ドキュメント
- 認証設定ガイド - 認証方法の詳細と設定例
使用上の注意
kintone-download-fileツールの注意点
- ダウンロードしたファイルは、
--attachments-dirまたはKINTONE_ATTACHMENTS_DIRで指定したディレクトリに保存されます。 --attachments-dirまたはKINTONE_ATTACHMENTS_DIRを指定しない場合はツール実行時にエラーになります。--attachments-dirまたはKINTONE_ATTACHMENTS_DIRに存在しないディレクトリを指定した場合は、ディレクトリを新規作成してからそこに保存されます。
制限事項
レコード操作の制限
- 添付ファイルフィールド: レコード登録更新ツールにおいて、添付ファイルフィールドは指定できません
- 選択フィールド: ユーザー選択フィールド、組織選択フィールド、グループ選択フィールドは、選択肢を設定している場合のみ登録更新が可能です
その他の制限
- ゲストスペースに非対応: ゲストスペース内のアプリにはアクセスできません
トラブルシューティング
接続エラーになる場合
- ベースURLが正しいか確認してください(例:
https://example.cybozu.com)。 - プロキシ環境下では、
HTTPS_PROXY環境変数を設定してください。 - 一時的に接続できない場合は、数分後に再試行してください。
認証エラーになる場合
- ユーザー名とパスワードが正しいか確認してください。
- ユーザー名・パスワードとAPIトークンを同時に指定していないか確認してください。
同時指定された場合は、パスワード認証が優先されます。 - クライアント証明書を使用している場合、セキュアアクセス用のドメインを使用していることを確認してください(例:
.s.cybozu.comなど、利用リージョンに応じます)。
権限エラーになる場合
- 使用しているユーザーまたはAPIトークンに、対象アプリへのアクセス権があるか確認してください。
(アプリ管理権限やレコード閲覧権限が必要な場合があります) - ゲストスペース内のアプリにはアクセスできません。
- APIトークンを使用している場合、必要な権限(「閲覧」「追加」「編集」「削除」など)が付与されているか確認してください。
サポート方針
kintoneローカルMCPサーバーは、APIサポート窓口の対象外です。
バグ報告・機能要望はIssuesから登録をお願いします。
コントリビューション
Contributing Guide を参照してください。
プライバシー
このMCPサーバーは、kintone REST APIに接続します。
利用地域に応じた公式プライバシーポリシーは、Privacy Policy Reference を参照してください。
ライセンス
Copyright 2025 Cybozu, Inc.
Licensed under the Apache 2.0.
kintone MCP questions
How do I add kintone MCP to Claude Code?
Run claude mcp add mcp-server -- npx -y @kintone/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add kintone MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What authentication methods are supported?
The server supports kintone username and password, API tokens, and client certificate authentication (PFX).
How do I handle proxy settings in a corporate environment?
You can set the HTTPS_PROXY environment variable to specify your proxy URL.