ClickUp MCP (Streamable HTTP)

다음 기능을 포함한 ClickUp REST API용 MCP 서버:

• 워크스페이스 전체 작업 검색 (GET /team/{team_id}/task)

• 작업 CRUD (+ 하위 작업)

• 기본 탐색 (팀, 공간, 폴더, 목록)

• 최근 활동 도우미 (date_updated_gt 및 사용 가능한 경우 감사 로그를 통해)

• 문서 CRUD/검색 (v3 API): 문서 및 페이지 검색, 가져오기, 생성

• 탈출구: 모든 ClickUp API 엔드포인트(v2 및 v3)를 호출할 수 있는 범용 도구.

이 서버는 Docker 서비스로 실행되어 OpenWebUI 및 LibreChat에서 사용하도록 설계되었습니다.

환경 변수

• CLICKUP_API_TOKEN (필수)

• CLICKUP_TEAM_ID (선택 사항, 설정되지 않은 경우 첫 번째 팀을 자동 감지)

• CLICKUP_WORKSPACE_ID (선택 사항; ClickUp은 v2에서 이를 종종 "team_id"라고 부름)

• CLICKUP_API_BASE_URL (선택 사항, 기본값 https://api.clickup.com/api/v2)

• CLICKUP_API_V3_BASE_URL (선택 사항, 기본값 https://api.clickup.com/api/v3)

실행 (로컬)

python -m clickup_mcp --transport streamable-http --host 0.0.0.0 --port 8000 --path /mcp

OpenWebUI는 다음 주소로 연결해야 합니다: http://clickup-mcp:8000/mcp

도구

작업 (v2 API)

• search_tasks - 이름/설명으로 작업 검색

• filter_tasks - 메타데이터(상태, 담당자, 날짜 등)별로 작업 필터링

• get_task - ID로 작업 가져오기

• create_task - 새 작업 생성

• create_subtask - 기존 작업 아래에 하위 작업 생성

• update_task - 작업 업데이트

• delete_task - 작업 삭제

• get_task_comments - 작업 댓글 가져오기

• create_task_comment - 작업에 댓글 생성

탐색 (v2 API)

• clickup_context - 확인된 컨텍스트(팀/워크스페이스 ID 및 현재 사용자) 가져오기

• list_teams - ClickUp 팀/워크스페이스 목록 표시

• get_team - ID로 팀 가져오기

• list_spaces - 팀 내 공간 목록 표시

• list_folders - 공간 내 폴더 목록 표시

• list_lists_in_space - 공간 내 (폴더 없는) 목록 표시

• list_lists_in_folder - 폴더 내 목록 표시

• list_tasks_in_list - 목록 내 작업 표시

문서 (v3 API)

• search_docs - 워크스페이스의 모든 문서 검색/목록 표시

• get_doc - ID로 문서 가져오기 (페이지 목록 포함)

• create_doc - 새 문서 생성

페이지 (v3 API)

• list_doc_pages - 문서 내 모든 페이지 목록 표시

• get_doc_page_listing - 문서의 계층적 페이지 구조 가져오기

• get_doc_page - 특정 페이지 가져오기 (콘텐츠 포함)

• create_doc_page - 문서 내 새 페이지 생성

• update_doc_page - 페이지 업데이트/편집 (콘텐츠 교체, 추가 또는 앞에 삽입)

유틸리티

• recent_activity - 최근 활동 가져오기 (감사 로그 또는 최근 업데이트된 작업)

• clickup_api_request - 범용 v2 API 탈출구

• clickup_v3_api_request - 범용 v3 API 탈출구

• health - 상태 확인