A
securityA
licenseA
qualityThis server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
5
56
7
TypeScript
MIT License
ClickUp 작업을 AI 애플리케이션과 통합하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 에이전트는 표준화된 프로토콜을 통해 ClickUp 작업, 공간, 목록 및 폴더와 상호 작용할 수 있습니다.
🚀 상태 업데이트: 완전한 시간 추적 지원 및 문서 관리 기능을 갖춘 v0.7.2가 출시되었습니다.
설정
- 신원 증명서를 받으세요:
- ClickUp 설정 의 ClickUp API 키
- ClickUp 작업 공간 URL의 팀 ID
- 호스팅 설치(웹훅 전송) 또는 NPX 설치(로컬 경로에 다운로드하고 종속성을 설치)를 선택하세요.
- 자연어를 사용하여 작업 공간을 관리하세요!
Smithery 설치(빠른 시작)
서버는 Smithery 에 호스팅됩니다. Smithery에서 사용 가능한 도구를 미리 보거나 특정 클라이언트 앱에서 실행할 명령을 복사할 수 있습니다.
NPX 설치
클라이언트의 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) 모드로 실행할 수 있습니다.
또는 명령줄을 통해서:
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 예제
특징
| 📝 작업 관리 | 🏷️ 태그 관리 |
|---|---|
| • 작업 생성, 업데이트 및 삭제• 어디서나 작업 이동 및 복제• 단일 및 대량 작업 지원• 자연어로 시작/마감일 설정• 하위 작업 생성 및 관리• 주석 및 첨부 파일 추가 | • 공간 태그 생성, 업데이트 및 삭제 • 작업에서 태그 추가 및 제거 • 자연어 색상 명령 사용 • 자동 대비 전경색 • 모든 공간 태그 보기 • 작업 공간 전체에서 태그 기반 작업 구성 |
| ⏱️ 시간 추적 | 🌳 작업 공간 구성 |
| • 작업에 대한 시간 항목 보기• 작업에 대한 시작/중지 시간 추적• 수동 시간 항목 추가• 시간 항목 삭제• 현재 실행 중인 타이머 보기• 청구 가능 및 청구 불가능 시간 추적 | • 공간, 폴더 및 목록 탐색• 폴더 생성 및 관리• 공간 내 목록 구성• 폴더 내 목록 생성• 작업 공간 계층 구조 보기• 효율적인 경로 탐색 |
| 📄 문서 관리 | 👥 회원 관리 |
| • 모든 작업 공간의 문서 목록 • 문서 페이지 목록 • 문서 페이지 세부 정보 • 문서 생성 • 문서 페이지 업데이트(추가 및 앞에 추가) | • 이름 또는 이메일로 작업 공간 구성원 찾기• 작업에 대한 담당자 확인• 구성원 세부 정보 및 권한 보기• 생성 중에 사용자에게 작업 할당• 사용자 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, 이메일 주소 또는 사용자 이름 배열을 허용합니다.
회원 관리 도구는 필요할 때 사용자 참조를 해결하는 데 도움이 됩니다.
프롬프트
아직 구현되지 않았으며 모든 클라이언트 앱에서 지원되는 것은 아닙니다. 워크플로에 가장 도움이 될 프롬프트 구현 기능을 요청해 주세요(너무 구체적이지 않은 범위 내에서). 예:
오류 처리
서버는 다음에 대한 명확한 오류 메시지를 제공합니다.
- 필수 매개변수가 없습니다
- 잘못된 ID 또는 이름
- 항목을 찾을 수 없습니다
- 권한 문제
- API 오류
- 속도 제한
LOG_LEVEL 환경 변수를 지정하여 서버 로그의 상세 수준을 제어할 수 있습니다. 유효한 값은 trace , debug , info , warn , error (기본값)입니다. 명령줄에서도 --env LOG_LEVEL=info 와 같이 지정할 수 있습니다.
개발자 지원
이 서버를 사용하시는 경우, 도구 응답에 이 저장소 링크가 포함된 작은 후원자 메시지가 가끔 표시될 수 있습니다. 이 프로젝트를 후원해 주시면 감사하겠습니다! 이 프로젝트가 도움이 되셨다면 다음 프로젝트를 후원해 주세요.
감사의 말
이러한 통합을 가능하게 해준 훌륭한 API와 서비스를 제공해준 ClickUp 에 특별히 감사드립니다.
기여하다
기여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
부인 성명
이 소프트웨어는 타사 API를 사용하며, 타사가 소유한 상표 또는 브랜드를 참조할 수 있습니다. 이러한 API 또는 참조의 사용은 해당 회사와의 제휴 또는 보증을 의미하지 않습니다. 모든 상표 및 브랜드 이름은 해당 소유자의 자산입니다. 이 프로젝트는 독립적인 저작물이며, 언급된 타사와 공식적으로 제휴하거나 후원받지 않습니다.
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
표준화된 프로토콜을 통해 ClickUp 작업과 AI 통합을 지원하여 리소스 관리, 작업 운영, 작업 공간 구성 및 AI 기반 작업 권장 사항을 제공합니다.
- Smithery 설치(빠른 시작)
- NPX 설치
- SSE 지원으로 실행
- Docker-compose 예제
- 특징
- 사용 가능한 도구
- 회원 관리 도구
- 프롬프트
- 오류 처리
- 개발자 지원
- 감사의 말
- 기여하다
- 특허
- 부인 성명
Related Resources
Related MCP Servers
- -securityFlicense-qualityEnables AI agents to control web browsers via a standardized interface for operations like launching, interacting with, and closing browsers.Last updated -0JavaScript
- AsecurityAlicenseAqualityAn enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.Last updated -40343TypeScriptMIT License
- AsecurityAlicenseAqualityClickUp MCP Server enables AI assistants to seamlessly interact with your ClickUp workspace. This powerful integration allows Claude to create and manage tasks, access documents, organize folders and lists, add comments, and handle checklists—all through natural conversation.Last updated -42594TypeScriptMIT License