Name: ClickUp MCP Server
Author: taazkareem

총 지지자 수 GitHub 스타

ClickUp 작업을 AI 애플리케이션과 통합하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 에이전트는 표준화된 프로토콜을 통해 ClickUp 작업, 공간, 목록 및 폴더와 상호 작용할 수 있습니다.

🚀 상태 업데이트: 완전한 시간 추적 지원 및 문서 관리 기능을 갖춘 v0.7.2가 출시되었습니다.

설정

신원 증명서를 받으세요:
- ClickUp 설정 의 ClickUp API 키
- ClickUp 작업 공간 URL의 팀 ID
호스팅 설치(웹훅 전송) 또는 NPX 설치(로컬 경로에 다운로드하고 종속성을 설치)를 선택하세요.
자연어를 사용하여 작업 공간을 관리하세요!

Related MCP server: ClickUp MCP Server

Smithery 설치(빠른 시작)

대장간 배지

서버는 Smithery 에 호스팅됩니다. Smithery에서 사용 가능한 도구를 미리 보거나 특정 클라이언트 앱에서 실행할 명령을 복사할 수 있습니다.

NPX 설치

NPM 버전 종속성 상태 NPM 다운로드

클라이언트의 MCP 설정 JSON 파일에 다음 항목을 추가하세요.

지엑스피1

또는 이 npx 명령을 사용하세요:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

주의: "DOCUMENT_SUPPORT": "true"를 전달하지 않으면 기본값은 false이고 문서 지원이 활성화되지 않습니다.

또한 DISABLED_TOOLS 환경 변수 또는 --env DISABLED_TOOLS 인수를 사용하여 특정 도구를 비활성화할 수 있습니다. 비활성화할 도구 이름을 쉼표로 구분하여 나열하세요(예: create_task,delete_task ).

도구 수나 컨텍스트 제한에 문제가 있는 경우 필요하지 않은 도구를 비활성화하세요.

SSE 지원으로 실행

다음 환경 변수를 설정하여 서버를 SSE(Server-Sent Events) 모드로 실행할 수 있습니다.

{ "mcpServers": { "ClickUp": { "command": "npx", "args": [ "-y", "@taazkareem/clickup-mcp-server@latest" ], "env": { "CLICKUP_API_KEY": "your-api-key", "CLICKUP_TEAM_ID": "your-team-id", "ENABLE_SSE": "true", "PORT": "8000" // Optional, defaults to 3231 } } } }

또는 명령줄을 통해서:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id --env ENABLE_SSE=true --env PORT=8000

Docker-compose 예제

version: '3.8' services: clickup-mcp-server: build: context: . dockerfile: Dockerfile ports: - '3231:8000' environment: - CLICKUP_API_KEY=${CLICKUP_API_KEY} - CLICKUP_TEAM_ID=${CLICKUP_TEAM_ID} - ENABLE_SSE=true - LOG_LEVEL=info - DOCUMENT_SUPPORT=true volumes: - ./src:/app/src restart: unless-stopped healthcheck: test: ["CMD", "curl", "-f", "http://localhost:8000/health"] interval: 30s timeout: 10s retries: 3 start_period: 5s

특징

📝 작업 관리	🏷️ 태그 관리
• 작업 생성, 업데이트 및 삭제• 어디서나 작업 이동 및 복제• 단일 및 대량 작업 지원• 자연어로 시작/마감일 설정• 하위 작업 생성 및 관리• 주석 및 첨부 파일 추가	• 공간 태그 생성, 업데이트 및 삭제 • 작업에서 태그 추가 및 제거 • 자연어 색상 명령 사용 • 자동 대비 전경색 • 모든 공간 태그 보기 • 작업 공간 전체에서 태그 기반 작업 구성
⏱️ 시간 추적	🌳 작업 공간 구성
• 작업에 대한 시간 항목 보기• 작업에 대한 시작/중지 시간 추적• 수동 시간 항목 추가• 시간 항목 삭제• 현재 실행 중인 타이머 보기• 청구 가능 및 청구 불가능 시간 추적	• 공간, 폴더 및 목록 탐색• 폴더 생성 및 관리• 공간 내 목록 구성• 폴더 내 목록 생성• 작업 공간 계층 구조 보기• 효율적인 경로 탐색
📄 문서 관리	👥 회원 관리
• 모든 작업 공간의 문서 목록 • 문서 페이지 목록 • 문서 페이지 세부 정보 • 문서 생성 • 문서 페이지 업데이트(추가 및 앞에 추가)	• 이름 또는 이메일로 작업 공간 구성원 찾기• 작업에 대한 담당자 확인• 구성원 세부 정보 및 권한 보기• 생성 중에 사용자에게 작업 할당• 사용자 ID, 이메일 또는 사용자 이름 지원• 팀 전체 사용자 관리
⚡ 통합 기능
• 글로벌 이름 또는 ID 기반 조회• 대소문자 구분 없이 일치• 마크다운 형식 지원• 내장된 속도 제한• 오류 처리 및 유효성 검사• 포괄적인 API 적용 범위

사용 가능한 도구

도구	설명	필수 매개변수
get_workspace_hierarchy	작업 공간 구조 가져오기	없음
작업 생성	작업 만들기	`name` , ( `listId` / `listName` )
대량 작업 생성	여러 작업 만들기	`tasks[]`
업데이트_작업	작업 수정	`taskId` / `taskName`
업데이트_대량_작업	여러 작업 업데이트	ID 또는 이름이 있는 `tasks[]`
get_tasks	목록에서 작업 가져오기	`listId` / `listName`
get_task	단일 작업 세부 정보 가져오기	`taskId` / `taskName` (스마트 구분 기능 포함)
get_workspace_tasks	필터링을 사용하여 작업 가져오기	최소한 하나 이상의 필터(태그, list_id, space_id 등)
get_task_comments	작업에 대한 의견 받기	`taskId` / `taskName`
작업_주석_생성	작업에 댓글 추가	`commentText` , ( `taskId` / ( `taskName` + `listName` ))
첨부_작업_파일	작업에 파일 첨부	`taskId` / `taskName` , ( `file_data` 또는 `file_url` )
삭제_작업	작업 제거	`taskId` / `taskName`
대량 작업 삭제	여러 작업 제거	ID 또는 이름이 있는 `tasks[]`
이동_작업	작업 이동	`taskId` / `taskName` , `listId` / `listName`
대량 작업 이동	여러 작업 이동	ID 또는 이름이 있는 `tasks[]` , 대상 목록
중복 작업	복사 작업	`taskId` / `taskName` , `listId` / `listName`
생성_리스트	공간에 목록 만들기	`name` , `spaceId` / `spaceName`
폴더 생성	폴더 만들기	`name` , `spaceId` / `spaceName`
폴더에_목록_만들기	폴더에 목록 만들기	`name` , `folderId` / `folderName`
폴더 가져오기	폴더 세부 정보 가져오기	`folderId` / `folderName`
업데이트_폴더	폴더 속성 업데이트	`folderId` / `folderName`
폴더 삭제	폴더 삭제	`folderId` / `folderName`
get_list	목록 세부 정보 가져오기	`listId` / `listName`
업데이트_목록	목록 속성 업데이트	`listId` / `listName`
삭제_목록	목록 삭제	`listId` / `listName`
get_space_tags	공간 태그 가져오기	`spaceId` / `spaceName`
생성_공간_태그	태그 생성	`tagName` , `spaceId` / `spaceName`
업데이트_공간_태그	태그 업데이트	`tagName` , `spaceId` / `spaceName`
삭제_공간_태그	태그 삭제	`tagName` , `spaceId` / `spaceName`
작업에 태그 추가	작업에 태그 추가	`tagName` , `taskId` / ( `taskName` + `listName` )
작업에서 태그를 제거하세요	작업에서 태그 제거	`tagName` , `taskId` / ( `taskName` + `listName` )
get_task_time_entries	작업에 대한 시간 항목 가져오기	`taskId` / `taskName`
시작_시간_추적	작업 시간 추적 시작	`taskId` / `taskName`
정지_시간_추적	현재 시간 추적 중지	없음
추가_시간_입력	작업에 수동 시간 입력 추가	`taskId` / `taskName` , `start` , `duration`
삭제_시간_항목	시간 항목 삭제	`timeEntryId`
현재 시간 입력 받기	현재 실행 중인 타이머 가져오기	없음
get_workspace_members	모든 작업 공간 멤버 가져오기	없음
이름으로 회원 찾기	이름이나 이메일로 회원 찾기	`nameOrEmail`
해결_담당자	멤버 이름을 ID로 변환	`assignees[]`
문서 생성	문서 만들기	`workspaceId` , `name` , `parentId` / `parentType` , `visibility` , `create_pages`
문서 가져오기	문서를 받으세요	`workspaceId` / `documentId`
문서 목록	문서 목록	`workspaceId` , `documentId` / `creator` / `deleted` / `archived` 됨 / `parent_id` / `parent_type` / `limit` / `next_cursor`
목록_문서_페이지	문서 페이지 나열	`documentId` / `documentName`
문서 페이지 가져오기	문서 페이지 가져오기	`documentId` / `documentName` , `pageIds`
문서 페이지 생성	문서 페이지 만들기	`workspaceId` / `documentId` , `parent_page_id` / `name` / `sub_title` , `content` / `content_format`
업데이트_문서_페이지	문서 페이지 업데이트	`workspaceId` / `documentId` , `name` / `sub_title` , `content` / `content_edit_mode` / `content_format`

선택적 매개변수와 고급 사용법에 대한 전체 문서를 참조하세요.

회원 관리 도구

이제 작업을 생성할 때 assignees 매개변수를 사용하여 사용자를 할당할 수 있습니다. 이 매개변수는 사용자 ID, 이메일 주소 또는 사용자 이름 배열을 허용합니다.

{ "name": "New Task", "description": "This is a new task.", "assignees": ["jdoe@example.com", "Jane Smith"] // Emails, usernames, or user IDs }

회원 관리 도구는 필요할 때 사용자 참조를 해결하는 데 도움이 됩니다.

프롬프트

아직 구현되지 않았으며 모든 클라이언트 앱에서 지원되는 것은 아닙니다. 워크플로에 가장 도움이 될 프롬프트 구현 기능을 요청해 주세요(너무 구체적이지 않은 범위 내에서). 예:

즉각적인	목적	특징
요약 작업	작업 개요	상태 요약, 우선순위, 관계
분석_우선순위	우선순위 최적화	분포 분석, 시퀀싱
생성_설명	작업 설명 생성	목표, 기준, 종속성

오류 처리

서버는 다음에 대한 명확한 오류 메시지를 제공합니다.

필수 매개변수가 없습니다
잘못된 ID 또는 이름
항목을 찾을 수 없습니다
권한 문제
API 오류
속도 제한

LOG_LEVEL 환경 변수를 지정하여 서버 로그의 상세 수준을 제어할 수 있습니다. 유효한 값은 trace , debug , info , warn , error (기본값)입니다. 명령줄에서도 --env LOG_LEVEL=info 와 같이 지정할 수 있습니다.

개발자 지원

이 서버를 사용하시는 경우, 도구 응답에 이 저장소 링크가 포함된 작은 후원자 메시지가 가끔 표시될 수 있습니다. 이 프로젝트를 후원해 주시면 감사하겠습니다! 이 프로젝트가 도움이 되셨다면 다음 프로젝트를 후원해 주세요.

스폰서 TaazKareem

감사의 말

이러한 통합을 가능하게 해준 훌륭한 API와 서비스를 제공해준 ClickUp 에 특별히 감사드립니다.

기여하다

기여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.

특허

라이센스: MIT

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

부인 성명

이 소프트웨어는 타사 API를 사용하며, 타사가 소유한 상표 또는 브랜드를 참조할 수 있습니다. 이러한 API 또는 참조의 사용은 해당 회사와의 제휴 또는 보증을 의미하지 않습니다. 모든 상표 및 브랜드 이름은 해당 소유자의 자산입니다. 이 프로젝트는 독립적인 저작물이며, 언급된 타사와 공식적으로 제휴하거나 후원받지 않습니다.

ClickUp MCP Server

설정