clickup-mcp

작업 관리에 초점을 맞춘 경량 ClickUp MCP 서버입니다. 토큰 최적화 응답을 제공하는 39개 도구 - API 응답을 수천 자에서 필수 정보만 남도록 자동으로 슬림화합니다.

이 서버가 필요한 이유?

ClickUp API는 매우 장황한 JSON을 반환합니다. 이 서버는 이를 핵심만 남기고 제거합니다:

토큰이 적을수록 = 더 빠른 응답, 더 낮은 비용, AI를 위한 더 많은 컨텍스트.

Related MCP server: ClickUp MCP Server

설치

npm install -g @cavort-it-systems/clickup-mcp

또는 직접 실행:

npx @cavort-it-systems/clickup-mcp

구성

Claude Code CLI

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp

Claude Desktop / 수동

MCP 구성(~/.claude.json 또는 Claude Desktop 설정)에 추가하세요:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@cavort-it-systems/clickup-mcp"],
      "env": {
        "CLICKUP_API_TOKEN": "your-token"
      }
    }
  }
}

소스에서 빌드

git clone https://github.com/cvrt-jh/clickup-mcp.git
cd clickup-mcp
npm install && npm run build

그런 다음 빌드된 경로로 구성하세요:

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- node /path/to/clickup-mcp/build/index.js

API 토큰 받기

1. ClickUp 설정 > 앱으로 이동

2. 개인 API 토큰 생성

3. CLICKUP_API_TOKEN으로 설정

응답 슬림화

모든 응답은 토큰을 절약하기 위해 자동으로 정리됩니다. ClickUp API는 매우 장황한 JSON을 반환하며, 이 서버는 중요한 정보만 남기고 제거합니다.

clickup_whoami - ~3,500자에서 ~160자로:

// Before (ClickUp API raw)
{"user":{"id":12345678,"username":"Jane Doe","email":"jane@example.com","color":"#0388d1",
"profilePicture":"https://attachments.clickup.com/...","initials":"JD",
"week_start_day":1,"global_font_support":true,"timezone":"Europe/Berlin"},
"teams":{"teams":[{"id":"99999999","name":"My Workspace","color":"#40BC86",
"avatar":"https://attachments2.clickup.com/...?Expires=...&Key-Pair-Id=...&Signature=...",
"members":[{"user":{"id":11111111,"username":"Bob Smith","email":"bob@example.com",
"color":"#aa2fff","profilePicture":null,"initials":"BS","role":4,"role_subtype":2,
"role_key":"guest","custom_role":null,"last_active":"...","date_joined":"...",
"date_invited":"..."},"invited_by":{"id":22222222,...},
"can_see_time_spent":true,...}, ...]}]}}

// After (slimmed)
{"id":12345678,"username":"Jane Doe","email":"jane@example.com",
"timezone":"Europe/Berlin","workspaces":[{"id":"99999999",
"name":"My Workspace","member_count":4}]}

clickup_create_comment - ~1,500자에서 38자로:

// Before
{"id":90150191300876,"hist_id":"...","date":1770053982842,
"version":{"object_type":"comment","object_id":"...","workspace_id":99999999,
"operation":"c","data":{"context":{"root_parent_type":1,"is_chat":false,
"audit_context":{"userid":12345678,"current_time":...,"route":"*"},...},...},...}}

// After
{"id":90150191300876,"date":1770053982842}

제거되는 항목:

도구 (37)

탐색 (7)

• clickup_whoami - 현재 사용자 + 워크스페이스

• clickup_get_spaces - 워크스페이스의 스페이스

• clickup_get_folders - 스페이스의 폴더

• clickup_get_lists - 폴더 또는 스페이스의 목록

• clickup_get_list - 단일 목록 상세 정보

• clickup_create_list - 폴더 또는 스페이스에 목록 생성

• clickup_delete_list - 목록 삭제(영구)

작업 CRUD (5)

• clickup_get_task - ID로 작업 가져오기

• clickup_create_task - 모든 필드로 작업 생성

• clickup_update_task - 작업 필드 업데이트

• clickup_get_tasks - 목록의 작업 나열

• clickup_search_tasks - 워크스페이스 전체에서 작업 검색

사용자 정의 필드 (1)

• clickup_set_custom_field - 사용자 정의 필드 값 설정

태그 (6)

• clickup_get_space_tags - 스페이스 태그 나열

• clickup_create_space_tag - 태그 생성

• clickup_edit_space_tag - 태그 편집

• clickup_delete_space_tag - 태그 삭제

• clickup_add_tag_to_task - 작업에 태그 추가

• clickup_remove_tag_from_task - 작업에서 태그 제거

체크리스트 (6)

• clickup_create_checklist - 체크리스트 생성

• clickup_edit_checklist - 체크리스트 편집

• clickup_delete_checklist - 체크리스트 삭제

• clickup_create_checklist_item - 항목 추가

• clickup_edit_checklist_item - 항목 편집

• clickup_delete_checklist_item - 항목 삭제

의존성 (4)

• clickup_add_dependency - 의존성 추가

• clickup_delete_dependency - 의존성 제거

• clickup_add_task_link - 작업 연결

• clickup_delete_task_link - 작업 연결 해제

댓글 (5)

• clickup_create_comment - 댓글 추가

• clickup_get_comments - 댓글 가져오기

• clickup_update_comment - 댓글 편집/해결

• clickup_create_reply - 스레드 답글

• clickup_get_replies - 답글 가져오기

작업 삭제 (1)

• clickup_delete_task - 작업 삭제

다중 목록 멤버십 (2)

• clickup_add_task_to_list - 작업을 추가 목록에 추가(멀티 호밍)

• clickup_remove_task_from_list - 추가 목록에서 작업 제거

이 작업은 작업을 이동시키지 않습니다. ClickUp v2 API에는 목록 간 이동 엔드포인트가 없습니다. 라이브 API에서 2026-08-12에 확인됨: POST /list/{list}/task/{task} 는 보조 위치를 추가하고 홈 목록은 변경하지 않은 채로 두는 반면, PUT /task/{id}의 list_id는 HTTP 200을 반환하지만 조용히 무시됩니다. 작업을 실제로 이동하고 사용자 지정 ID와 기록을 유지하려면 ClickUp 웹 UI를 사용하세요(마우스 오른쪽 버튼 클릭 -> 이동). 다중 목록 멤버십에는 유료 기능인 Tasks-in-Multiple-Lists도 필요합니다.

워크스페이스 멤버 (2)

• clickup_get_workspace_members - 모든 워크스페이스 멤버

• clickup_get_list_members - 목록별 멤버

아키텍처

src/
  index.ts          # Entry: McpServer + StdioServerTransport
  client.ts         # ClickUp API v2 fetch wrapper
  types.ts          # Shared Zod schemas + jsonResult helper
  slim.ts           # Response slimming transformers
  tools/
    navigation.ts   # 7 tools
    tasks.ts        # 9 tools (CRUD + custom fields + delete + multi-list)
    tags.ts         # 6 tools
    checklists.ts   # 6 tools
    dependencies.ts # 4 tools
    comments.ts     # 5 tools
    members.ts      # 2 tools

라이선스

MIT