monday-automation

Rube MCP による Monday.com の自動化

Composio の Monday ツールキットを通じて、ボードの作成、アイテム管理、列の値の更新、グループの整理、サブアイテム、更新/コメントスレッドなど、Monday.com のワーク管理ワークフローを自動化します。

前提条件

• Rube MCP が接続されている必要があります（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS をツールキット monday で使用して、Monday.com 接続がアクティブであること
• 最新のツールスキーマを取得するには、常に最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です — エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを検証します
2. RUBE_MANAGE_CONNECTIONS をツールキット monday で呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Monday.com OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE と表示されることを確認します

コアワークフロー

1. ボードの作成と管理

使用するタイミング: ユーザーが新しいボードを作成したり、既存のボードを一覧表示したり、ワークスペース構造を設定したりしたい場合。

ツールの順序:

1. MONDAY_GET_WORKSPACES - 利用可能なワークスペースを一覧表示し、ワークスペース ID を解決します [前提条件]
2. MONDAY_LIST_BOARDS - 重複を確認するために既存のボードを一覧表示します [任意]
3. MONDAY_CREATE_BOARD - 名前、種類、ワークスペースを指定して新しいボードを作成します [必須]
4. MONDAY_CREATE_COLUMN - 新しいボードに列を追加します [任意]
5. MONDAY_CREATE_GROUP - アイテムを整理するためのグループを追加します [任意]
6. MONDAY_BOARDS - ボードの詳細なメタデータを取得します [任意]

主要なパラメータ:

• board_name: 新しいボードの名前（必須）
• board_kind: "public"、"private"、または "share"（必須）
• workspace_id: 数値のワークスペース ID。デフォルトのワークスペースを使用する場合は省略します
• folder_id: フォルダ ID。両方を指定する場合は workspace_id 内に存在する必要があります
• template_id: 複製するアクセス可能なテンプレートの ID

注意点:

• board_kind は必須であり、"public"、"private"、"share" のいずれかである必要があります
• workspace_id と folder_id の両方を指定する場合、フォルダはそのワークスペース内に存在する必要があります
• template_id は、認証されたユーザーがアクセスできるテンプレートを参照する必要があります
• ボード ID は大きな整数です。常に API レスポンスから取得した正確な値を使用してください

2. アイテムの作成と管理

使用するタイミング: ユーザーがボードにタスク/アイテムを追加したり、既存のアイテムを一覧表示したり、グループ間でアイテムを移動したりしたい場合。

ツールの順序:

1. MONDAY_LIST_BOARDS - ボード名をボード ID に解決します [前提条件]
2. MONDAY_LIST_GROUPS - ボード上のグループを一覧表示して group_id を取得します [前提条件]
3. MONDAY_LIST_COLUMNS - 値を設定するための列 ID と型を取得します [前提条件]
4. MONDAY_CREATE_ITEM - 名前と列の値を指定して新しいアイテムを作成します [必須]
5. MONDAY_LIST_BOARD_ITEMS - ボード上のすべてのアイテムを一覧表示します [任意]
6. MONDAY_MOVE_ITEM_TO_GROUP - アイテムを別のグループに移動します [任意]
7. MONDAY_ITEMS_PAGE - フィルタリングを伴うページ分割されたアイテムの取得 [任意]

主要なパラメータ:

• board_id: ボード ID（必須、整数）
• item_name: アイテム名、最大 256 文字（必須）
• group_id: アイテムを配置するグループ ID 文字列（任意）
• column_values: 列 ID を値にマッピングする JSON オブジェクトまたは文字列

注意点:

• column_values は列 ID（タイトルではない）を使用する必要があります。MONDAY_LIST_COLUMNS から取得してください
• 列の値の形式は型によって異なります。ステータスは {"index": 0} または {"label": "Done"}、日付は {"date": "YYYY-MM-DD"}、担当者は {"personsAndTeams": [{"id": 123, "kind": "person"}]} を使用します
• item_name は最大 256 文字です
• サブアイテムのボードは MONDAY_CREATE_ITEM ではサポートされていません。MONDAY_CREATE_OBJECT を介して GraphQL を使用してください

3. アイテムの列の値を更新する

使用する場面：既存のアイテムのステータス、日付、テキスト、その他の列の値を変更したい場合です。

ツールの実行順序：

1. MONDAY_LIST_COLUMNS または MONDAY_COLUMNS - 列の ID と種類を取得します［前提条件］
2. MONDAY_LIST_BOARD_ITEMS または MONDAY_ITEMS_PAGE - 対象アイテムの ID を確認します［前提条件］
3. MONDAY_CHANGE_SIMPLE_COLUMN_VALUE - 文字列の値でテキスト、ステータス、ドロップダウンを更新します［必須］
4. MONDAY_UPDATE_ITEM - JSON を使って、タイムライン、ユーザー、日付などの複雑な列の種類を更新します［必須］

MONDAY_CHANGE_SIMPLE_COLUMN_VALUE の主なパラメーター：

• board_id：ボード ID（整数、必須）
• item_id：アイテム ID（整数、必須）
• column_id：列 ID の文字列（必須）
• value：単純な文字列の値（例：「Done」、「Working on it」）
• create_labels_if_missing：ステータス／ドロップダウンのラベルを自動作成する場合は true（デフォルトは true）

MONDAY_UPDATE_ITEM の主なパラメーター：

• board_id：ボード ID（整数、必須）
• item_id：アイテム ID（整数、必須）
• column_id：列 ID の文字列（必須）
• value：列の種類のスキーマに一致する JSON オブジェクト
• create_labels_if_missing：デフォルトは false。ステータス／ドロップダウンの場合は true に設定します

注意点：

• 単純なテキスト／ステータス／ドロップダウンの更新には、MONDAY_CHANGE_SIMPLE_COLUMN_VALUE（文字列の値）を使用します
• タイムライン、ユーザー、日付などの複雑な種類には、MONDAY_UPDATE_ITEM（JSON の値）を使用します
• 列 ID は小文字とアンダースコアで構成される文字列です（例：「status_1」、「date_2」、「text」）。MONDAY_LIST_COLUMNS で取得します
• ステータスの値は、ラベル名（「Done」）またはインデックス番号（「1」）で設定できます
• create_labels_if_missing のデフォルト値は異なります。CHANGE_SIMPLE では true、UPDATE_ITEM では false です

4. グループとボード構造を操作する

使用する場面：アイテムをグループに整理したり、列を追加したり、ボード構造を確認したりしたい場合です。

ツールの実行順序：

1. MONDAY_LIST_BOARDS - ボード ID を特定します［前提条件］
2. MONDAY_LIST_GROUPS - ボード上のすべてのグループを一覧表示します［必須］
3. MONDAY_CREATE_GROUP - 新しいグループを作成します［任意］
4. MONDAY_LIST_COLUMNS または MONDAY_COLUMNS - 列構造を確認します［必須］
5. MONDAY_CREATE_COLUMN - ボードに新しい列を追加します［任意］
6. MONDAY_MOVE_ITEM_TO_GROUP - グループ間でアイテムを再編成します［任意］

主なパラメーター：

• board_id：ボード ID（グループ／列に関するすべての操作で必須）
• group_name：新しいグループの名前（CREATE_GROUP）
• column_type：有効な GraphQL enum トークンを snake_case で指定する必要があります（例：「status」、「text」、「long_text」、「numbers」、「date」、「dropdown」、「people」）
• title：列に表示するタイトル
• defaults：ステータス／ドロップダウンのラベルを指定する JSON 文字列（例：'{"labels": ["To Do", "In Progress", "Done"]}'）

注意点：

• column_type には正確な snake_case の値を指定する必要があります。「person」は無効です。「people」を使用してください
• グループ ID は文字列です（例：「topics」、「new_group_12345」）。整数ではありません
• MONDAY_COLUMNS は board_ids の配列を受け取り、設定を含む列のメタデータを返します
• MONDAY_LIST_COLUMNS はよりシンプルで、単一の board_id を受け取ります

5. サブアイテムと更新を管理する

使用するタイミング：タスクのサブアイテムを表示したい場合や、アイテムにコメント／更新を追加したい場合です。

ツールの実行順序：

1. MONDAY_LIST_BOARD_ITEMS - 親アイテムの ID を検索します［前提条件］
2. MONDAY_LIST_SUBITEMS_BY_PARENT - 列の値を含むサブアイテムを取得します［必須］
3. MONDAY_CREATE_UPDATE - アイテムにコメント／更新を追加します［任意］
4. MONDAY_CREATE_OBJECT - GraphQL ミューテーションでサブアイテムを作成します［任意］

MONDAY_LIST_SUBITEMS_BY_PARENT の主なパラメーター：

• parent_item_ids：親アイテムの ID の配列（整数配列、必須）
• include_column_values：列のデータを含める場合は true（デフォルトは true）
• include_parent_fields：親アイテムの情報を含める場合は true（デフォルトは true）

MONDAY_CREATE_OBJECT の主なパラメーター（GraphQL）：

• query：GraphQL ミューテーション文字列全体
• variables：任意の変数オブジェクト

注意事項：

• サブアイテムを取得できるのは、親アイテムを通じてのみです
• サブアイテムを作成するには、create_subitem GraphQL ミューテーションを指定して MONDAY_CREATE_OBJECT を使用します
• MONDAY_CREATE_UPDATE はアイテムへのコメント／更新の追加（Monday の「更新」機能）に使用するものであり、アイテムの値の変更には使用しません
• MONDAY_CREATE_OBJECT は GraphQL の生のエンドポイントです。正しいミューテーション構文を使用してください

よくあるパターン

ID の解決

操作の前に、表示名を必ず ID に解決してください：

• ボード名 -> board_id：MONDAY_LIST_BOARDS を使用し、名前で照合します
• グループ名 -> group_id：board_id を指定して MONDAY_LIST_GROUPS を使用します
• 列タイトル -> column_id：board_id を指定して MONDAY_LIST_COLUMNS を使用します
• ワークスペース名 -> workspace_id：MONDAY_GET_WORKSPACES を使用し、名前で照合します
• アイテム名 -> item_id：MONDAY_LIST_BOARD_ITEMS または MONDAY_ITEMS_PAGE を使用します

ページネーション

Monday.com では、アイテムにカーソルベースのページネーションを使用します：

• MONDAY_ITEMS_PAGE は、次のページ用の cursor をレスポンスで返します
• 次の呼び出しに cursor を渡してください。カーソルを指定すると、board_id と query_params は無視されます
• カーソルは 60 分間キャッシュされます
• 1 ページあたりの limit の最大値は 500 です
• MONDAY_LIST_BOARDS と MONDAY_GET_WORKSPACES は、page と limit を使用するページベースのページネーションを使用します

列の値の形式

列のタイプごとに異なる値の形式が必要です：

• ステータス：{"index": 0}、{"label": "Done"}、または単純な文字列 "Done"
• 日付：{"date": "YYYY-MM-DD"}
• ユーザー：{"personsAndTeams": [{"id": 123, "kind": "person"}]}
• テキスト／数値：プレーンな文字列または数値
• タイムライン：{"from": "YYYY-MM-DD", "to": "YYYY-MM-DD"}

既知の注意事項

ID の形式

• ボード ID とアイテム ID は大きな整数です（例：1234567890）
• グループ ID は文字列です（例："topics"、"new_group_12345"）
• 列 ID は短い文字列です（例："status_1"、"date4"、"text"）
• ワークスペース ID は整数です

レート制限

• Monday.com GraphQL API には、複雑さに基づくレート制限があります
• 列が多い大規模なボードでは、クエリの複雑さが増します
• レート制限に達した場合は、limit パラメーターを使ってリクエストごとのアイテム数を減らしてください

パラメーターに関する注意点

• CREATE_COLUMN の column_type には、正確な snake_case の列挙値を指定する必要があります。"person" ではなく "people" を使用してください
• CREATE_ITEM の column_values は、JSON 文字列とオブジェクトのどちらの形式も受け付けます
• MONDAY_CHANGE_SIMPLE_COLUMN_VALUE は、デフォルトで存在しないラベルを自動作成しますが、MONDAY_UPDATE_ITEM は作成しません
• MONDAY_CREATE_OBJECT は GraphQL の生のインターフェイスです。専用のツールがない操作（例：create_subitem、delete_item、archive_board）に使用してください

レスポンスの構造

• ボードアイテムは、id、name、state フィールドを含む配列として返されます
• 列の値には、生の value（JSON）と描画済みの text（表示文字列）の両方が含まれます
• サブアイテムは親アイテムの下にネストされており、単独では取得できません

クイックリファレンス

タスク	ツールスラッグ	主なパラメータ
ワークスペースの一覧表示	MONDAY_GET_WORKSPACES	kind, state, limit
ワークスペースの作成	MONDAY_CREATE_WORKSPACE	name, kind
ボードの一覧表示	MONDAY_LIST_BOARDS	limit, page, state
ボードの作成	MONDAY_CREATE_BOARD	board_name, board_kind, workspace_id
ボードのメタデータ取得	MONDAY_BOARDS	board_ids, board_kind
グループの一覧表示	MONDAY_LIST_GROUPS	board_id
グループの作成	MONDAY_CREATE_GROUP	board_id, group_name
列の一覧表示	MONDAY_LIST_COLUMNS	board_id
列のメタデータ取得	MONDAY_COLUMNS	board_ids, column_types
列の作成	MONDAY_CREATE_COLUMN	board_id, column_type, title
アイテムの作成	MONDAY_CREATE_ITEM	board_id, item_name, column_values
ボードアイテムの一覧表示	MONDAY_LIST_BOARD_ITEMS	board_id
ページネーションされたアイテム	MONDAY_ITEMS_PAGE	board_id, limit, query_params
列の更新 (単純)	MONDAY_CHANGE_SIMPLE_COLUMN_VALUE	board_id, item_id, column_id, value
列の更新 (複雑)	MONDAY_UPDATE_ITEM	board_id, item_id, column_id, value
アイテムをグループへ移動	MONDAY_MOVE_ITEM_TO_GROUP	item_id, group_id
サブアイテムの一覧表示	MONDAY_LIST_SUBITEMS_BY_PARENT	parent_item_ids
コメント/更新の追加	MONDAY_CREATE_UPDATE	item_id, body
生の GraphQL ミューテーション	MONDAY_CREATE_OBJECT	query, variables

使用するタイミング

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用できます。

例

ユーザーリクエスト:

Rube MCP (Composio) を介して、ボード、アイテム、列、グループ、サブアイテム、更新を含む Monday.com のワークマネジメントを自動化します。

制限事項

• このスキルは、タスクが上記で説明された範囲に明確に一致する場合にのみ使用してください。
• 出力を、環境に固有の検証、テスト、または専門家によるレビューの代替物として扱わないでください。
• 必要な入力、権限、安全境界、または成功基準が欠けている場合は、停止して確認を求めてください。