Monday.com MCP Server

Monday.com MCP サーバー

Monday.com のタスク関連操作を処理する、TypeScript 製の Model Context Protocol（MCP）サーバー実装です。

利用可能なツール

この MCP サーバーでは、Monday.com とやり取りするために、次のツールを利用できます。

• my-items：設定したボードで、現在のユーザーに割り当てられているアイテムを取得します
• add-task：Monday.com のボードに新しいタスク（アイテム）を追加します
• update-task-status：インテリジェントなステータスマッチングを使って、タスク（アイテム）のステータスを更新します
• update-task：カスタム列の値を使って、タスク（アイテム）を更新します（高度な操作）
• get-groups：Monday.com のボードからすべてのグループを取得します
• get-item-details：特定のアイテムについて、すべての列と値を含む詳細情報を取得します

ステータス更新の例

update-task-status ツールは、インテリジェントなステータスマッチングを提供します。次のような自然言語を使用できます。

• 「進行中」：「In Progress」、「Working」、「WIP」などに一致します
• 「完了」：「Done」、「Complete」、「Completed」、「Finished」などに一致します
• 「レビュー中」：「In Review」、「Review」、「Pending Review」などに一致します
• 「停滞中」：「Stuck」、「Blocked」、「Blocker」などに一致します

はじめに

オプション 1：直接使用（推奨）

クローンせずに、pnpm dlx でパッケージを直接使用します。

1. MCP サーバーを設定する

   ~/.cursor/mcp.json ファイルで環境変数を設定します。

   {
     "mcpServers": {
       "monday": {
         "command": "pnpm",
         "args": ["dlx", "@nasseratic/monday-mcp-server@latest"],
         "env": {
          "MONDAY_API_KEY": "your_monday_api_key",
          "MONDAY_TASKS_BOARD_ID": "your_monday_board_id"
        }
      }
    }
   

}

 - `MONDAY_API_KEY`：Monday.com API トークンです。
 - `MONDAY_TASKS_BOARD_ID`：タスクを含む Monday.com ボードの ID です

### オプション 2：開発環境のセットアップ

ソースコードを変更する場合や、コントリビュートする場合は、次の手順に従います。

1. **リポジトリをクローンする**

 ```bash
 git clone https://github.com/Nasseratic/mcp-server-monday.git
 cd mcp-server-monday

2. 依存関係をインストールする

   pnpm install
   

3. 開発環境の設定

   ローカルの開発バージョンを使用するには、~/.cursor/mcp.json ファイルで環境変数を設定します。

   {
     "mcpServers": {
       "monday": {
         "command": "pnpm",
         "args": ["start"],
         "cwd": "/path/to/your/mcp-server-monday",
         "env": {
          "MONDAY_API_KEY": "your_monday_api_key",
          "MONDAY_TASKS_BOARD_ID": "your_monday_board_id"
        }
      }
    }
   

}

 - `/path/to/your/mcp-server-monday` を、リポジトリをクローンした実際のパスに置き換えます。

## Monday.com API のセットアップ

Monday.com API トークンを取得するには、次の手順に従います。

1. Monday.com アカウントに移動します
2. アバター > Developers > My API tokens をクリックします
3. 適切な権限を付与した新しい API トークンを生成します

Monday.com のボード ID を取得するには、次の手順に従います。

1. Monday.com でボードを開きます
2. URL の「boards/」の後にある数字がボード ID です