Skip to main content
Glama
r3-yamauchi

Kintone MCP Server

by r3-yamauchi

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KINTONE_DOMAINYesThe kintone domain in the format [subdomain].cybozu.com
KINTONE_PASSWORDYesThe kintone user's password in plain text
KINTONE_USERNAMEYesThe kintone username for MCP connection

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}
prompts
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_record

kintoneアプリの1レコードを取得します。事前に対象アプリのフィールド構造を把握したい場合は、`get_form_fields` ツールで利用予定のフィールドコードを確認してから本ツールを呼び出してください。

search_records

kintoneアプリのレコードを検索します。事前に対象アプリのフィールド一覧を把握するため、`get_form_fields` ツールで利用予定のフィールドコードやフィールドタイプを確認してからクエリーを作成することを推奨します。

【よく使用されるクエリ例】 • 文字列検索: Customer = "サイボウズ株式会社" (完全一致) • 部分一致: Customer like "株式会社" (部分一致) • ドロップダウン: Status in ("対応中","未対応") (複数値の選択) • 日付範囲: LimitDay >= "2022-09-29" and LimitDay <= "2022-10-29" • 日付関数: LimitDay < TODAY() (今日より前) • 複数条件: Status in ("対応中") and LimitDay < TODAY() • ソート: Status = "対応中" order by 更新日時 desc • ページング: Status = "対応中" order by $id desc limit 20 offset 20 • 空欄チェック: Detail is empty (文字列複数行の空欄) • 非空欄チェック: Detail is not empty (文字列複数行の非空欄) • 添付ファイル有無: Attachments is empty / is not empty • ユーザー検索: 作成者 in (LOGINUSER()) (自分が作成したレコード)

注意: is empty / is not empty は「文字列(複数行)」と「添付ファイル(FILE)」に対してのみ使用でき、「文字列(1行)」などの他のフィールドタイプに対しては使用できません。 クエリ式の詳細仕様や構文とすべての演算子や関数、フィールド別の使用可否といったkintoneの仕様については get_query_language_documentation ツールを実行して確認してください。

create_record

kintoneアプリに新しいレコードを作成します。事前に対象アプリのフィールド構造を把握するため、`get_form_fields` やフォームの配置情報を確認できる`get_form_layout` を実行し、必要なフィールドコードと配置を整理してから本ツールを使用することを推奨します。各フィールドは { "value": ... } の形式で指定します。 例: { "app_id": 1, "fields": { "文字列1行": { "value": "テスト" }, "文字列複数行": { "value": "テスト\nテスト2" }, "数値": { "value": "20" }, "日時": { "value": "2014-02-16T08:57:00Z" }, "チェックボックス": { "value": ["sample1", "sample2"] }, "ユーザー選択": { "value": [{ "code": "sato" }] }, "ドロップダウン": { "value": "sample1" }, "リンク_ウェブ": { "value": "https://www.cybozu.com" }, "テーブル": { "value": [{ "value": { "テーブル文字列": { "value": "テスト" } } }] } } }

update_record

kintoneアプリの既存レコードを更新します。更新前に`get_form_fields` や`get_form_layout` でフィールド構造とレイアウトを確認し、利用するフィールドコードが最新であることをチェックしてから操作してください。各フィールドは { "value": ... } の形式で指定します。 例1(レコードIDを指定して更新): { "app_id": 1, "record_id": 1001, "fields": { "文字列1行_0": { "value": "character string is changed" }, "テーブル_0": { "value": [{ "id": 1, "value": { "文字列1行_1": { "value": "character string is changed" } } }]} } }

例2(重複禁止フィールドを指定して更新): { "app_id": 1, "updateKey": { "field": "文字列1行_0", "value": "フィールドの値" }, "fields": { "文字列1行_1": { "value": "character string is changed" }, "テーブル_0": { "value": [{ "id": 1, "value": { "文字列1行_2": { "value": "character string is changed" } } }]} } } レコードIDまたはupdateKeyのいずれかを指定して更新できます。updateKeyを使用する場合は、重複禁止に設定されたフィールドを指定してください。

add_record_comment

kintoneレコードにコメントを追加します

update_record_status

kintoneレコードのステータスを更新します(プロセス管理)

update_record_assignees

kintoneレコードの作業者を更新します(プロセス管理)

get_record_comments

kintoneレコードのコメントを取得します。limit未指定の場合は内部でページングして全件を取得します。大量データになる場合は limit(例: 10)を指定することを推奨します。

create_records

kintoneアプリに複数のレコードを一括作成します(最大100件)

upsert_record

重複禁止フィールド(updateKey)またはレコードIDをキーに、存在すれば更新・無ければ作成する upsert 機能を使用します。実行前に get_form_fieldsget_form_layout でフィールド構造を確認し、利用するフィールドコードが最新であることをチェックしてから実行してください。各フィールドは { "value": ... } の形式で指定します。

upsert_records

複数レコードを一括Upsertします。各要素に重複禁止フィールド(updateKey)と更新内容を指定すると、存在するレコードは更新、存在しないレコードは新規作成されます。最大100件。

get_process_management

kintoneアプリのプロセス管理設定を取得します

update_process_management

kintoneアプリのプロセス管理設定を更新します

get_apps_info

アプリ名(またはその部分文字列)で検索、アプリIDで絞り込み、さらに任意でアプリコードやスペースIDでも絞り込んでkintoneアプリの情報を取得します。app_nameapp_id のいずれか一方は必ず指定し、app_codespace_id は任意で組み合わせ可能です。

create_app

新しいkintoneアプリを作成します

deploy_app

kintoneアプリの設定をデプロイします

get_deploy_status

kintoneアプリのデプロイ状態を確認します

update_app_settings

kintoneアプリの一般設定を変更します

get_form_layout

kintoneアプリのフォームレイアウトを取得します

update_form_layout

kintoneアプリのフォームレイアウトを変更します。トップレベルには ROW と SUBTABLE と GROUP を配置できます。SUBTABLEやGROUPはトップレベルに配置する必要があります。ROW内に配置することはできません。SUBTABLEをレイアウトに含める際には、fieldsプロパティでテーブル内に表示するフィールドとその順序を指定する必要があります。また、ルックアップフィールドをフォームに配置する際は 250 以上の幅を明示的に指定してください。

move_app_to_space

kintoneアプリを指定したスペースに移動します

move_app_from_space

kintoneアプリをスペースに所属させないようにします。注意: kintoneシステム管理の「利用する機能の選択」で「スペースに所属しないアプリの作成を許可する」が有効になっている必要があります。

get_preview_app_settings

プレビュー環境のkintoneアプリ設定を取得します

get_form_fields

kintoneアプリのフォームフィールド情報を取得します。対象アプリが本番環境に存在しない場合はエラーとなります。プレビュー環境の情報を取得したい場合は get_preview_form_fields を使用してください。

get_preview_form_fields

プレビュー環境のkintoneアプリのフォームフィールド情報を取得します

get_preview_form_layout

プレビュー環境のkintoneアプリのフォームレイアウト情報を取得します

get_app_actions

kintoneアプリのアクション設定を取得します。レスポンスには各アクションの実行条件(filterCond)も含まれます。filterCondは、アプリアクションを実行できる条件をkintoneクエリ構文で定義したものです。

get_app_plugins

kintoneアプリに追加されているプラグインの一覧を取得します

get_views

kintoneアプリの一覧(ビュー)の設定を取得します

update_views

kintoneアプリの一覧(ビュー)の設定を更新します

get_app_acl

kintoneアプリのアクセス権限を取得します

get_field_acl

kintoneアプリのフィールドのアクセス権限を取得します

update_field_acl

kintoneアプリのフィールドのアクセス権限を更新します

get_reports

kintoneアプリのグラフ設定を取得します

update_reports

kintoneアプリのグラフ設定を更新します

get_notifications

kintoneアプリの通知条件設定を取得します

update_notifications

kintoneアプリの通知条件設定を更新します

get_per_record_notifications

kintoneアプリのレコード単位の通知設定を取得します

update_per_record_notifications

kintoneアプリのレコード単位の通知設定を更新します

get_reminder_notifications

kintoneアプリのリマインダー通知設定を取得します

update_reminder_notifications

kintoneアプリのリマインダー通知設定を更新します

update_app_actions

kintoneアプリのアクション設定を更新します。各アクションにはfilterCondプロパティを指定して実行条件を設定できます。例: {"actions": {"アクション名": {"name": "アクション名", "index": "0", "filterCond": "Status = "対応中"", ...}}}

update_plugins

kintoneアプリのプラグイン設定を更新します

get_app_customize

kintoneアプリのJavaScript/CSSカスタマイズ設定を取得します

update_app_customize

kintoneアプリのJavaScript/CSSカスタマイズ設定を更新します

update_app_acl

kintoneアプリのアクセス権限を更新します

get_record_acl

指定したレコードのアクセス権限を取得します

evaluate_records_acl

指定した条件でレコードのアクセス権限を評価します

get_space

スペースの一般情報を取得します

update_space

スペースの設定を更新します

update_space_body

スペースの本文を更新します

get_space_members

スペースメンバーのリストを取得します

update_space_members

スペースメンバーを更新します

add_thread

スペースにスレッドを追加します

update_thread

スレッドを更新します

add_thread_comment

スレッドにコメントを追加します

update_space_guests

スペースのゲストメンバーを更新します

add_fields

kintoneアプリにフィールドを追加します。各フィールドには code(フィールドコード)、type(フィールドタイプ)、label(表示名)の指定が必須です。 初期値を設定する際は、フィールドタイプごとに defaultValue または defaultNowValue を使用できます。defaultValue には文字列を指定し、日付なら "YYYY-MM-DD"、時刻なら "HH:MM"、日時なら "YYYY-MM-DDTHH:MM:SS" 形式を守ってください。defaultNowValue は true/false または "true"/"false" を受け付け、省略時は false として扱われます。 日付・時刻・日時フィールドで defaultValuedefaultNowValue: true を同時に指定した場合、defaultNowValue: true が優先され defaultValue は無視されます。 フィールドコードに使用できる文字: ひらがな、カタカナ、漢字、英数字、記号(__・・$¥) 注意: システムフィールドタイプ(CREATOR, MODIFIER, RECORD_NUMBER, CREATED_TIME, UPDATED_TIME)は追加できません。これらはkintoneによって自動的に作成されるフィールドです。 type: CREATOR のようなシステムフィールドタイプを指定すると、エラーが発生します。 代替方法として、以下のようなフィールドを追加できます:

  • CREATOR(作成者)の代わりに「申請者」などの名前でUSER_SELECTフィールド

  • MODIFIER(更新者)の代わりに「承認者」などの名前でUSER_SELECTフィールド

  • CREATED_TIME(作成日時)の代わりに「申請日時」などの名前でDATETIMEフィールド

  • UPDATED_TIME(更新日時)の代わりに「承認日時」などの名前でDATETIMEフィールド

  • RECORD_NUMBER(レコード番号)の代わりに「管理番号」などの名前でSINGLE_LINE_TEXTフィールド 例: { "app_id": 123, "properties": { "number_field": { "type": "NUMBER", "code": "number_field", "label": "数値フィールド" }, "text_field": { "type": "SINGLE_LINE_TEXT", "code": "text_field", "label": "テキストフィールド" } } } また、ルックアップフィールドをフォームに配置する際は 250 以上の幅を明示的に指定してください。

update_field

既存のkintoneフィールドの設定を更新します。 注意: システムフィールドタイプ(CREATOR, MODIFIER, RECORD_NUMBER, CREATED_TIME, UPDATED_TIME)は更新できません。 例: { "app_id": 123, "field_code": "text_field", "field": { "type": "SINGLE_LINE_TEXT", "code": "text_field", "label": "更新後のラベル", "required": true } }

create_choice_field

選択肢フィールド(ラジオボタン、チェックボックス、ドロップダウン、複数選択)の設定を生成します。 フィールドコードに使用できる文字: ひらがな、カタカナ、漢字、英数字、記号(__・・$¥) 例: { "field_type": "RADIO_BUTTON", "code": "radio_field", "label": "ラジオボタン", "choices": ["選択肢1", "選択肢2", "選択肢3"], "align": "HORIZONTAL" }

create_reference_table_field

関連テーブルフィールドの設定を生成します。 フィールドコードに使用できる文字: ひらがな、カタカナ、漢字、英数字、記号(__・・$¥) 例: { "code": "related_table", "label": "関連テーブル", "relatedAppId": 123, "conditionField": "customer_id", "relatedConditionField": "customer_id" }

create_lookup_field

ルックアップフィールドの設定を生成します。 フィールドコードに使用できる文字: ひらがな、カタカナ、漢字、英数字、記号(__・・$¥) 例: { "code": "lookup_field", "label": "ルックアップ", "relatedAppId": 123, "relatedKeyField": "customer_id", "fieldMappings": [ { "field": "name", "relatedField": "customer_name" }, { "field": "email", "relatedField": "customer_email" } ] }

get_field_type_documentation

フィールドタイプに関するドキュメントを取得します

get_available_field_types

利用可能なフィールドタイプの一覧を取得します

get_documentation_tool_description

ドキュメントツールの説明を取得します

get_field_creation_tool_description

フィールド作成ツールの説明を取得します

get_query_language_documentation

kintoneクエリ言語(検索クエリ)に関する詳細なドキュメントを取得します。演算子、条件式、並び替え、ページングなどの使い方を説明します。

create_form_layout

フィールド情報からフォームレイアウトを自動生成します

add_layout_element

既存のフォームレイアウトに要素を追加します

create_group_layout

グループ要素を作成します

create_table_layout

テーブルレイアウトを作成します

get_users

kintoneのユーザー情報を取得します

get_groups

kintoneのグループ情報を取得します

get_group_users

指定したグループに所属するユーザーの一覧を取得します

add_guests

ゲストユーザーを追加します

get_kintone_domain

kintoneの接続先ドメインを取得します

get_kintone_username

kintoneへの接続に使用されるユーザー名を取得します

download_file

kintoneアプリからファイルをダウンロードします。注意: 現在の実装では1MB以上のファイルは正常にダウンロードできない場合があります。

upload_file

kintoneアプリにファイルをアップロードします

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/r3-yamauchi/kintone-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server