# ClickUp MCP Server

[ClickUp](https://clickup.com/) のタスク管理を行う [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) サーバーです。

ClickUp API v2 を使用して、タスクの検索・作成・更新・削除、ワークスペース情報の取得、コメントの管理ができます。

## 提供ツール（15個）

### ワークスペース

| ツール名 | 説明 |
|---|---|
| `get_teams` | チーム（ワークスペース）一覧を取得 |
| `get_spaces` | スペース一覧を取得 |
| `get_folders` | フォルダー一覧を取得 |
| `get_lists` | スペース直下のリスト一覧を取得 |
| `get_folder_lists` | フォルダー内のリスト一覧を取得 |

### タスク管理

| ツール名 | 説明 |
|---|---|
| `create_task` | タスクを作成（担当者・タグ・優先度・日時指定可） |
| `get_tasks` | リスト内のタスク一覧を取得（自動ページネーション） |
| `get_task_detail` | タスクの詳細情報を取得 |
| `update_task` | タスクの各フィールドを更新（汎用） |
| `update_task_status` | タスクのステータスを更新 |
| `delete_task` | タスクを削除 |

### 検索・分析

| ツール名 | 説明 |
|---|---|
| `search_tasks` | 高度な検索（ステータス・担当者・タグ・日付フィルタ） |
| `get_weekly_summary` | ステータス別タスクサマリーを取得 |

### コメント

| ツール名 | 説明 |
|---|---|
| `add_comment` | タスクにコメントを追加 |
| `get_task_comments` | タスクのコメント一覧を取得 |

## セットアップ

### 1. ClickUp API キーの取得

[ClickUp Settings > Apps](https://app.clickup.com/settings/apps) で API キーを取得してください。

### 2. MCP クライアントに設定

#### Claude Desktop

`claude_desktop_config.json` に以下を追加:

```json
{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "clickup-mcp"],
      "env": {
        "CLICKUP_API_KEY": "pk_your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id"
      }
    }
  }
}
```

#### Claude Code

プロジェクトルートの `.mcp.json` またはCLIで追加:

```json
{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "clickup-mcp"],
      "env": {
        "CLICKUP_API_KEY": "pk_your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id"
      }
    }
  }
}
```

#### ローカルで実行する場合

```bash
git clone https://github.com/yourname/clickup-mcp.git
cd clickup-mcp
npm install
npm run build
```

MCP クライアント設定:

```json
{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["/path/to/clickup-mcp/build/index.js"],
      "env": {
        "CLICKUP_API_KEY": "pk_your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id"
      }
    }
  }
}
```

## 主な機能

### 自動ページネーション

`get_tasks` と `search_tasks` は最大10ページ（1000件）まで自動取得します。

### 配列パラメータ

`search_tasks` の `assignees`、`statuses`、`tags` は配列で渡せます。ClickUp API が要求する `key[]` 形式に自動変換されます。

### 日時の柔軟なパース

日時パラメータは以下の形式に対応しています:

- `2026-02-19`（日付のみ）
- `2026-02-19T14:30`（ISO形式）
- `2026-02-19 14:30:00`（スペース区切り）
- `2026/02/19`（スラッシュ区切り）

## 環境変数

| 変数名 | 必須 | デフォルト | 説明 |
|---|---|---|---|
| `CLICKUP_API_KEY` | Yes | — | ClickUp API キー |
| `CLICKUP_TEAM_ID` | Yes | — | チーム（ワークスペース）ID |
| `CLICKUP_DEFAULT_LIST_ID` | No | — | デフォルトリストID |

## ライセンス

MIT