This server provides MCP tools to manage kintone apps, form configurations, records, comments, process statuses, general settings, deployments, and file downloads.
Retrieve app details, form fields/layouts, process management, general settings, and deploy status.
Add, update, or delete form fields and form layouts in the pre-live environment.
Query, add, update, and delete records with filtering, sorting, pagination, and revision control.
Update record statuses for process-managed apps.
Add and retrieve record comments, including mentions.
Update app general settings and deploy pre-live changes to production.
Download kintone attachment files to a local directory by fileKey.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@kintone MCP Server get records from Customer App where status is Active"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
日本語 | English
kintoneの公式ローカルMCPサーバーです。
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 run -i --rm \
-e KINTONE_BASE_URL=https://example.cybozu.com \
-e KINTONE_USERNAME=(username) \
-e KINTONE_PASSWORD=(password) \
ghcr.io/kintone/mcp-serverNode.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` でも指定可能です。Related MCP server: mcp-kintone-lite
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"
}
}
}
}コマンドライン引数 | 環境変数 | 説明 | 必須 |
|
| kintone環境のベースURL（例: | ✓ |
|
| kintoneのログインユーザー名 | ※1 |
|
| kintoneのログインパスワード | ※1 |
|
| APIトークン（カンマ区切りで最大9個まで指定可能） | ※1 |
|
| Basic認証のユーザー名 | - |
|
| Basic認証のパスワード | - |
|
| PFXファイルのパス（クライアント証明書認証用） | - |
|
| PFXファイルのパスワード | - |
|
| HTTPSプロキシのURL（例: | - |
|
| ダウンロードしたファイルの保存先 | - |
※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"ツール名 | 説明 |
| 複数のアプリ情報を取得 |
| 単一アプリの詳細情報を取得 |
| アプリのフィールド設定を取得 |
| アプリのフォームレイアウトを取得 |
| アプリのフィールド設定を更新 |
| アプリのフォームレイアウトを更新 |
| アプリのフィールドを削除 |
| プロセス管理設定を取得 |
| アプリ設定の運用環境への反映状況確認 |
| アプリの一般設定を取得 |
| JavaScript / CSSカスタマイズ設定を取得 |
| アプリにフィールドを追加 |
| 複数のレコードを取得 |
| 複数のレコードを追加 |
| 複数のレコードを更新 |
| 複数のレコードを削除 |
| 複数のレコードのステータスを更新 |
| レコードのコメントを取得 |
| レコードにコメントを追加 |
| 動作テスト環境にアプリを作成 |
| アプリ設定を運用環境へ反映 |
| アプリの一般設定を変更 |
| 添付ファイルフィールドのファイルを保存 |
| テンプレートからスペースを作成 |
| スペースの設定を更新 |
| スペースの情報を取得 |
| スペースを削除 |
認証設定ガイド - 認証方法の詳細と設定例
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.
Add new fields to a kintone app (preview environment only). Requires App Management permissions. Field codes must be unique, max 128 chars, cannot start with numbers, and only '_' symbol allowed. For selection fields (DROP_DOWN/RADIO_BUTTON/CHECK_BOX/MULTI_SELECT), option keys must exactly match their label values. Options require 'label' and 'index' properties. For lookup fields, use appropriate field type (NUMBER for RECORD_NUMBER, SINGLE_LINE_TEXT for text fields). Use kintone-get-form-fields first to check existing fields. Changes require kintone-deploy-app to apply to live app.
Inputs: app (required), properties (required), revision. Returns: revision
Add a single comment to a kintone record. The kintone API accepts one comment per call; to add comments to multiple records, call this tool repeatedly.
Inputs: app (required), text (required), record (required), mentions. Returns: id
Add multiple records to a kintone app. Use kintone-get-form-fields tool first to discover available field codes and their required formats. Note: Some fields cannot be registered (LOOKUP copies, STATUS, CATEGORY, CALC, ASSIGNEE, auto-calculated fields).
Inputs: app (required), records (required). Returns: ids, revisions
Delete form fields from a kintone app (preview environment only). Maximum 100 fields can be deleted at once. Cannot delete status, assignee, or category fields. Useful for recreating lookup fields when updates fail. Use kintone-get-form-fields first to verify field codes. Changes require kintone-deploy-app to apply to live app.
Inputs: app (required), fields (required), revision. Returns: revision
Delete multiple records from a kintone app. Maximum 100 records can be deleted at once.
Inputs: app (required), ids (required), revisions. Returns: object
Deploy app settings from pre-live to production environment on kintone. This is an asynchronous API - use kintone-get-app-deploy-status tool to check deployment progress.
Inputs: apps (required), revert. Returns: message
Download a file from kintone using its fileKey and save it to the configured download directory. Returns the absolute path to the saved file. Requires KINTONE_ATTACHMENTS_DIR environment variable to be set, app record viewing permission, and permission to view the field containing the file.
Inputs: fileKey (required), fileName (required). Returns: filePath, fileSize, mimeType
Get app settings from kintone
Inputs: appId (required). Returns: code, name, appId, creator, +6 more
Get app deploy status from kintone
Inputs: apps (required). Returns: apps
Get form field settings from a kintone app. Returns detailed field information including type, code, label, and all configuration settings (required status, default values, validation rules, options for selection fields, lookup configurations). Response includes 'properties' object with all fields and 'revision' string. Essential for understanding current field structure before add/update/delete operations. Use to verify lookup field configurations and field mappings. Supports both live and pre-live app settings retrieval.
Inputs: app (required), lang, preview. Returns: revision, properties
Get form layout from a kintone app. Returns layout structure with rows, subtables, groups, and field positioning. Use to understand current form arrangement before layout updates. Essential when adding new fields that need specific positioning or when rearranging existing fields. Supports both live and pre-live app settings retrieval.
Inputs: app (required), preview. Returns: layout, revision
Get general settings of a kintone app
Inputs: app (required), lang, preview. Returns: icon, name, theme, revision, +9 more
Get process management settings from a kintone app
Inputs: app (required), lang, preview. Returns: enable, states, actions, revision
Get comments posted on a single kintone record. The kintone API returns comments for one record at a time; to fetch comments for multiple records, call this tool repeatedly. Up to 10 comments are returned per call; use offset to paginate.
Inputs: app (required), record (required), limit, order, +1 more. Returns: newer, older, comments
Get multiple records from a kintone app with structured filtering. All filter conditions are AND-combined; OR conditions are not supported by this MCP server. Use kintone-get-form-fields tool first to discover available fields and their types.
Inputs: app (required), limit, fields, offset, +2 more. Returns: records, totalCount
Update form field settings in a kintone app (preview environment only). Requires App Management permissions. Only type is required per field; omit code or label to keep their current values. Cannot update field codes for Label, Blank space, Border, Status, Assignee, or Category fields. For selection fields, unspecified options will be deleted. Option keys must exactly match current option names. For lookup fields, existing lookup configurations may not update properly - consider deleting and recreating the field instead. Use kintone-get-form-fields first to check current settings. Changes require kintone-deploy-app to apply to live app.
Inputs: app (required), properties (required), revision. Returns: revision
Update form layout settings in a kintone app (preview environment only). Use kintone-get-form-fields and kintone-get-form-layout first to understand current structure. Field codes are case-sensitive and must match exactly. For SUBTABLE fields, use nested structure: {type: 'SUBTABLE', code: 'table_code', fields: [{type: 'field_type', code: 'field_code'}, ...]}. Required when adding new fields to ensure proper positioning. Changes require kintone-deploy-app to apply to live app.
Inputs: app (required), layout (required), revision. Returns: revision
Update the general settings of a kintone app. Changes are made to the pre-live environment, which is a temporary storage area where app information is saved before deployment. To reflect changes to the production environment, execute the kintone-deploy-app tool after this tool.
Inputs: app (required), icon, name, theme, +10 more. Returns: revision
Update multiple records in a kintone app. Use kintone-get-form-fields tool first to discover available field codes and their required formats. Note: Some fields cannot be updated (LOOKUP copies, STATUS, CATEGORY, CALC, ASSIGNEE, auto-calculated fields).
Inputs: app (required), records (required). Returns: records
Update status of multiple records in a kintone app. Requires process management feature to be enabled. Maximum 100 records can be updated at once.
Inputs: app (required), records (required). Returns: records
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 20 tools
Most tools target clearly distinct resources and actions (form fields, records, layout, comments, deploy). However, kintone-get-app is broadly described as 'Get app settings' and overlaps conceptually with kintone-get-general-settings and kintone-get-form-fields, which could cause slight confusion.
All tool names follow a consistent kebab-case pattern with the 'kintone-' prefix and a verb-noun structure (e.g., kintone-get-records, kintone-update-form-fields). There are no deviations in case or ordering.
With 20 tools, the set is on the heavy side for the domain. While each tool has a distinct role, the count falls into the borderline 16–25 range per the rubric, suggesting some consolidation may be possible.
The surface covers CRUD for records and form fields well, but has significant gaps: no tool to create or delete apps, no file upload despite a download tool, and process management is read-only. These missing operations could cause agent failures for common kintone tasks.
Official MCP server for Lovable, the AI-powered full-stack app builder.
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Official MCP server for Qase — manage test cases, runs, suites, defects via AI tools.
Official MCP server for subfeed.app — the cloud for agents. 15+ tools for AI agents to register, build, and deploy other agents. Zero human required. Start here: subfeed.app/skill.md
