Monday

🌟 概要

monday.com の AI チームが管理するこのリポジトリでは、monday.com との連携を希望する AI エージェント開発者向けに、包括的なツールセットを提供しています。AI アシスタント、自動化機能、カスタム連携のいずれを構築する場合でも、これらのツールを使えば monday.com プラットフォームに簡単に接続できます。

👉 monday MCP を初めてお使いですか？こちらから始めましょう：monday.com/w/mcp

https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd

🔑 monday.com とは？

monday.com は、チームがプロセス、プロジェクト、日々の業務を進めるためのワーク OS です。チームは monday.com を使って、ひとつの一元化されたプラットフォーム上で業務の計画、追跡、管理を行います。視覚的で直感的なインターフェースを備えており、チームは次のことができます。

• カスタマイズ可能なボードを使ってプロジェクトを作成・管理する
• ステータス列でタスクの各段階を追跡する
• 更新やメンションを通じてチームメンバーと共同作業する
• ワークフローを自動化し、他のツールと連携する
• ダッシュボードやレポートでデータを視覚化する

📦 内容

💻 monday API MCP サーバー

@mondaydotcomorg/monday-api-mcp パッケージは、Model Context Protocol（MCP）向けの、すぐに使えるサーバー実装を提供します。AI エージェントは複雑な連携を構築することなく、monday.com API とやり取りできます。

🤖 エージェントツールキット

@mondaydotcomorg/agent-toolkit パッケージは、monday.com API とやり取りする AI エージェントの構築に役立つ強力なツールとユーティリティのセットを提供し、OpenAI と Model Context Protocol（MCP）の両方の実装をサポートします。

🚀 クイックスタート：ホスト型 MCP（推奨）

monday.com に接続する最速で、堅牢かつ信頼性の高い方法です。 ホスト型 MCP サービスがインフラストラクチャをすべて管理するため、ローカルでのセットアップは不要で、自動更新とパフォーマンスの向上を利用できます。

📚 インテグレーションガイド

お好みの AI プラットフォームで利用を始めましょう。

• はじめに - monday MCP を初めてお使いですか？
• Claude との連携 - Claude Desktop に接続します
• Cursor との連携 - Cursor IDE と連携します
• ChatGPT との連携 - ChatGPT に接続します
• MS Copilot との連携 - Microsoft Copilot Studio と連携します
• Mistral との連携 - Mistral AI の le Chat に接続します
• すぐに使えるプロンプト - すぐに始められるプロンプトの例です

ホスト型 MCP のクイックセットアップ

Cursor の場合

MCP の設定に次の内容を追加するだけです。

{
  "mcpServers": {
    "monday-mcp": {
      "url": "https://mcp.monday.com/mcp"
    }
  }
}

ホスト型 MCP を使う理由

• ✅ ローカルへのインストール不要 - セットアップせずにすぐ使えます
• ✅ 自動更新 - 常に最新の機能を利用できます
• ✅ 優れたパフォーマンス - 最適化されたインフラストラクチャ
• ✅ OAuth 認証 - トークンを安全に管理します
• ✅ ワークスペースの制御 - 特定のワークスペースへのアクセスに制限できます
• ✅ 高い信頼性 - エンタープライズ水準の稼働率

代わりにこのリポジトリを使う場合

MCP をローカルで実行する場合や、エージェントツールキットを使う場合は、次のようなニーズが考えられます。

• 🔧 MCP サーバーをカスタマイズする - 特定のニーズに合わせてソースコードを変更します
• 🛠️ カスタムエージェントを構築する - OpenAI 向け、または独自の実装にエージェントツールキットを使用します
• 🔌 オフラインで作業する - インターネットに接続せずに開発します
• 🧪 開発に貢献する - MCP サーバーやツールキットの改善に協力します

🏁 ローカルインストールガイド

ステップ 1：monday.com アカウントを作成する

monday.com アカウントをまだお持ちでない場合は、次の手順に従います。

1. monday.com にアクセスしてアカウントを登録します
2. 最初のワークスペースとボードを作成して、利用を始めます

ステップ 2：API トークンを生成する

monday.com の API を利用するには、API トークンが必要です。

1. monday.com アカウントにログインします
2. 左下にあるアバターをクリックします
3. 「Developers」を選択します
4. 左側のメニューで「My access tokens」をクリックします
5. 個人用アクセストークンをコピーします

ステップ 3：MCP クライアントを設定する

Claude Desktop の場合

1. Claude Desktop を開きます
2. 「設定」→「MCP Servers」に移動します
3. 次の設定を使用してサーバーを追加します。

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

Gemini CLI の場合

Gemini CLI を始めるには、monday.com 用の公式 Gemini CLI 拡張機能を使用できます。

Gemini CLI 拡張機能には、コンテキストファイルとカスタムコマンドが含まれた monday.com MCP サーバーがバンドルされています。これにより、Gemini が monday.com のツールを使って強力なワークフローを実行する方法を学習できます。

拡張機能をインストールするには、ターミナルで次のコマンドを実行します。

gemini extensions install https://github.com/mondaycom/mcp

拡張機能を使わずに MCP サーバーを直接使用する場合は、次のコマンドで追加できます。

gemini mcp add -t http monday https://mcp.monday.com/mcp

拡張機能をインストールするか、MCP サーバーを追加したら、次を実行して Gemini CLI を起動します。

gemini

次に、Gemini CLI 内で次のコマンドを実行して、monday.com アカウントで認証します。

/mcp auth monday

ブラウザーウィンドウが開き、認証手続きを完了できます。 認証後、monday.com のすべてのツールとカスタムコマンドを利用できるようになります。

拡張機能で試せるカスタムコマンドの例：

• /monday:create-item ボード 123 に「Update the UI」のアイテムを作成します
• /monday:sprint-summary スプリント 853 の概要を表示します

Cursor またはその他の MCP クライアントの場合（ローカルセットアップ）

設定に追加します。

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

ステップ 5：連携をテストする

1. Claude または AI アシスタントに、次のような質問をします。

   • 「ボード 123 にはどのアイテムがありますか？」
   • 「プロジェクトを管理するためのボードを作成できますか？」

2. これで、アシスタントが monday.com アカウントとやり取りできるようになります！

⚙️ ホスト型 MCP の高度な設定

認証ヘッダーの使用

ホスト型 MCP でカスタム認証ヘッダーと API バージョンを指定するには、次のようにします。

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "-p",
        "node@20",
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your_token>"
      }
    }
  }
}

API バージョンの指定

--header パラメーターを使用して、使用する API バージョンを指定できます。

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Api-Version:${API_VERSION}"
      ],
      "env": {
        "API_VERSION": "2025-07"
      }
    }
  }
}

Monday MCP アプリのインストール

OAuth 認証とワークスペースの管理機能を利用するには、マーケットプレイスから Monday MCP アプリをインストールします。

1. マーケットプレイスの monday MCP アプリにアクセスします。
2. 「Install」をクリックし、手順に従ってアカウントに追加します。

🧰 利用可能なツール

MCP サーバーは、AI アシスタントが monday.com とやり取りするための豊富なツールを提供します。

カテゴリ	ツール	説明
アイテム操作	create_item	指定した列の値を使って、monday.com のボードに新しいアイテムを作成します
	delete_item	ボードからアイテムを完全に削除します
	get_board_items_by_name	ボード ID と検索語／名前でアイテムを検索します
	create_update	特定のアイテムに更新／コメントを追加します
	change_item_column_values	既存のアイテムの列の値を変更します
	move_item_to_group	同じボード内の別のグループにアイテムを移動します
ボード操作	create_board	指定した列を含む新しい monday.com ボードを作成します
	get_board_schema	ボードの列とグループの構造を取得します
	create_group	monday.com ボードに新しいグループを作成します
	create_column	既存のボードに新しい列を追加します
	delete_column	ボードから列を削除します
アカウント操作	list_users_and_teams	ID、名前、またはアカウント内の検索によって、ユーザーまたはチームの詳細を取得します
WorkForms 操作	create_form	新しい monday.com フォームを作成します
	get_form	トークンを使ってフォームを取得します

🎨 monday.com アプリフレームワークのツール

AI の支援を受けてカスタム monday.com アプリを開発したいですか？アプリフレームワークのツールを使うと、AI エージェントが monday.com のアプリ開発プラットフォームをすべて利用できるようになり、AI アシスタントを通じてカスタムアプリを直接作成、管理、デプロイできます。

📖 アプリフレームワークのツールに関するドキュメント全文を見る

🔮 動的 API ツール（ベータ版）

動的 API ツール機能は、AI エージェントが monday.com とやり取りする方法を大きく進化させます。標準ツールでは一般的な操作に対応していますが、動的 API ツールを使うと、monday.com GraphQL API のあらゆる機能を活用できます。

動的 API ツールとは？

動的 API ツールを使うと、AI エージェントは monday.com の API 全体に、完全かつ柔軟にアクセスできます。これにより、AI アシスタントは次のことができます。

1. 任意の API エンドポイントにアクセス - あらかじめ用意された操作だけに限られません
2. カスタム GraphQL クエリを生成 - あらゆる状況に必要なクエリを正確に作成します
3. monday.com のスキーマを動的に探索 - 利用可能なすべてのデータ型とその関係を把握します

主な動的 API ツール

ツール	説明
all_monday_api	GraphQL クエリまたはミューテーションを動的に生成して実行します
get_graphql_schema	利用可能な操作を把握するために、monday.com の GraphQL スキーマを取得します
get_type_details	特定の GraphQL 型に関する詳細情報を取得します

広がる可能性

動的 API ツールを使うと、AI アシスタントは次のことができます。

• 複数のボード、アイテム、データポイントにまたがる複雑なレポートを作成
• 多数のアイテムに対して一括操作を実行
• ドキュメント、ワークスペース、アクティビティログなど、monday.com の高度な機能と深く連携
• monday.com が API に機能を追加した際に、新しい機能を発見

有効化方法

Dynamic API Tools はベータ版で、デフォルトでは無効になっています。次の方法で有効にできます。

MONDAY_TOKEN=your_monday_api_token npx @mondaydotcomorg/monday-api-mcp@latest --enable-dynamic-api-tools true

「only」モードを使用して、Dynamic API Tools のみを有効にすることもできます。

MONDAY_TOKEN=your_monday_api_token npx @mondaydotcomorg/monday-api-mcp@latest --enable-dynamic-api-tools only

「only」モードを有効にすると、サーバーは Dynamic API Tools のみを提供し、その他の標準ツールはすべて除外します。これは、GraphQL API を直接操作したい上級ユーザーに便利です。

⚠️ 注意：Dynamic API Tools には API へのフルアクセスが必要で、読み取り専用モードとは互換性がありません。

🖥️ MCP サーバーの設定

引数	フラグ	説明	必須	デフォルト
monday.com API トークン	--token、-t	monday.com API トークン	はい	-
API バージョン	--version、-v	monday.com API バージョン	いいえ	current
モード	--mode、-m	ツールモード：標準プラットフォームツールには default、Apps Framework ツールには apps	いいえ	default
読み取り専用モード	--read-only、-ro	読み取り専用モードを有効にします	いいえ	false
Dynamic API Tools	--enable-dynamic-api-tools、-edat	Dynamic API Tools を有効にします	いいえ	false

🔐 認証とセキュリティ

サーバーが monday.com API で認証するには、monday.com API トークンが必要です。このトークンは次の 2 つの方法で指定できます。

1. 環境変数：MONDAY_TOKEN=your_monday_api_token
2. コマンドライン引数：-t your_monday_api_token

セキュリティのベストプラクティス

• 公開リポジトリやディスカッションで API トークンを共有しないでください
• データの取得のみが必要な場合は、読み取り専用モード（--read-only）の使用を検討してください
• セキュリティを強化するため、API トークンは 定期的にローテーションしてください

📚 使用例

ツールを使って作成できるものの例を紹介します。

1. プロジェクト管理用 AI アシスタント

• monday.com のボードでタスクを作成、管理します
• プロジェクトのステータスを確認します
• 進行に応じてアイテムをグループ間で移動します

2. データ分析とレポート作成

• monday.com のボードからデータを抽出します
• レポートや分析情報を作成します
• レポート用の新しいボードを作成します

🌐 コミュニティとサポート

• GitHub Issues：バグ報告や機能リクエスト
• Discussions：質問やコミュニティでのディスカッション
• monday.com 開発者向けドキュメント：monday.com API の詳細をご確認ください

📚 ドキュメント

• monday API MCP ドキュメント
• Agent Toolkit ドキュメント
• monday.com API リファレンス

📋 前提条件

これらのツールを使用する前に、次のものが揃っていることを確認してください。

1. Node.js v20 以降がインストールされていること
2. NPM v5.2.0 以降がインストールされていること
3. monday.com API トークン

🛠️ リポジトリでの開発方法

リポジトリで開発するには、次の手順を実行します。

1. リポジトリをクローンします
2. 依存関係をインストールします：yarn install
3. プロジェクトをビルドします：yarn build
4. monday-api-mcp パッケージ内の dist/index.js ファイルのパスをコピーします。
5. ローカルで動作するように設定を変更します

    "monday-api-mcp": {
      "command": "node",
      "args": [
        "<your_full_path_to_the_package>/dist/index.js",
        "--enable-dynamic-api-tools",
        "true"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }

🤝 コントリビューション

コミュニティからのコントリビューションを歓迎します。バグの修正、ドキュメントの改善、新機能の追加など、皆さまのご協力に感謝します。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します：git checkout -b feature/amazing-feature
3. 変更をコミットします：git commit -m 'Add some amazing feature'
4. ブランチにプッシュします：git push origin feature/amazing-feature
5. プルリクエストを作成します

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

このサーバーは monday.com API を使用しており、monday.com の開発者向け利用規約が適用されることを明記します。

---