ClickUp

제공 도구 10

발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.

• clickup__api_destructive파괴적승인 필요

  ClickUp v2·v3 destructive 메서드 실행. clickup__operations에서 operation과 필수 입력을 먼저 얻는다. ⚠️ 삭제·병합·멤버/권한·웹훅 변경은 데이터를 잃거나 공유 범위를 바꾸며 되돌릴 수 없는 경우가 있다. 결과: data · next_query · truncated · response_fragment. 임의 URL·메서드·헤더·GraphQL·batch는 허용하지 않는다.

• clickup__api_send발신승인 필요

  ClickUp v2·v3 send 메서드 실행. clickup__operations에서 operation과 필수 입력을 먼저 얻는다. ⚠️ 태스크·코멘트·첨부 변경은 사용자 알림과 자동화를 실행하며 발송 알림은 되돌릴 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다. 결과: data · next_query · truncated · response_fragment. 임의 URL·메서드·헤더·GraphQL·batch는 허용하지 않는다.

• clickup__create_task발신승인 필요

  ClickUp 리스트에 태스크를 생성한다. ⚠️ 팀 전체에 보이고 담당자에게 알림이 나가며 발송된 알림은 되돌릴 수 없다 — 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). list_id 는 clickup__find_list 결과의 list_id(추측하지 않는다), status 는 그 결과의 statuses 목록에 있는 이름만. 결과: created · task_id · name · status · list · url.

• clickup__update_task발신승인 필요

  ClickUp 태스크의 준 필드만 수정한다(상태 변경 포함, description 은 본문을 대체). ⚠️ 상태 변경은 담당자 알림과 ClickUp Automations 를 함께 발화시키고, 발송된 알림과 자동화의 효과는 되돌릴 수 없다 — 바꾸기 전에 clickup__search_tasks 결과로 지금 값을 확인해 둔다. 요청에 바뀔 내용이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다. status 는 그 리스트의 statuses 목록(clickup__find_list)에 있는 이름. task_id 는 clickup__search_tasks 결과의 task_id. 결과: updated · task_id · name · status · list · url.

• clickup__api_write쓰기

  ClickUp v2·v3 write 메서드 실행. clickup__operations에서 operation과 필수 입력을 먼저 얻는다. 개인 시간 기록·타이머를 변경한다. 결과: data · next_query · truncated · response_fragment. 임의 URL·메서드·헤더·GraphQL·batch는 허용하지 않는다.

• clickup__api_read읽기

  ClickUp v2·v3 read 메서드 실행. clickup__operations에서 operation과 필수 입력을 먼저 얻는다. 태스크 상세·코멘트·멤버와 Workspace 자원을 읽는다. 결과: data · next_query · truncated · response_fragment. 임의 URL·메서드·헤더·GraphQL·batch는 허용하지 않는다.

• clickup__find_list읽기

  리스트 탐색 — 스페이스·폴더를 한 번에 훑어 list_id 와 그 리스트에서 쓸 수 있는 상태(statuses) 목록을 함께 준다. 태스크를 만들거나 상태를 바꾸기 전에 먼저 부른다. query 는 리스트·폴더·스페이스 이름의 부분일치, 결과가 많으면 space 로 좁힌다. 결과: 리스트마다 list_id · list · folder · space · space_id · tasks · statuses.

• clickup__list_workspaces읽기

  ClickUp 워크스페이스(team) 목록. 다른 ClickUp 툴의 workspace 인자에 쓸 id 를 얻는다. 워크스페이스가 하나뿐이면 다른 툴이 자동 선택하므로 부를 필요가 없다

• clickup__operations읽기

  ClickUp v2·v3 메서드·필수 path/query/body 스키마 탐색. group/search로 좁히고 operation을 주면 상세 스키마를 얻는다. GetTask·코멘트·멤버(담당자 id)·Docs·Chat·ACL 포함. 결과: operation · risk · input · pagination · limitation. OAuth scope는 없고 Workspace/역할/플랜 권한이 적용된다.

• clickup__search_tasks읽기

  태스크 조회 — 담당자·상태·리스트·마감 기간으로 거른다(기본은 열린 태스크만). ⚠️ 키워드 전문 검색은 없다(ClickUp API 제약) — 필터로 범위를 좁힌 뒤 결과에서 제목으로 고른다. 결과: 태스크마다 task_id · name · status · list · list_id · assignees · priority · due · url (최대 25건).

연동 준비

1. 필요한 Workspace를 승인하고 계정 역할·요금제 권한을 확인하세요. OAuth scope는 없습니다. 기존 토큰 권한은 DB 변경으로 확대되지 않습니다. Workspace 누락 시 연결 해제 후 재연동·재동의하고, 403은 관리자·Enterprise 권한도 확인하세요. 바로가기