Clockify Automation
Claude Code에서 직접 Clockify 시간 추적 작업을 자동화하세요. 시간 항목을 기록하고, 과거 데이터를 조회하며, 워크스페이스를 관리하고 팀 활동을 감사할 수 있습니다. 터미널을 벗어날 필요가 없습니다.
툴킷 문서: composio.dev/toolkits/clockify
설정
- Rube MCP 서버를 Claude Code 설정에 URL
https://rube.app/mcp로 추가하세요. - 메시지가 표시되면 제공된 연결 링크를 통해 Clockify 계정을 인증하세요.
- 자연어로 시간 추적 워크플로우 자동화를 시작하세요.
핵심 워크플로우
1. 시간 항목 생성
프로젝트, 작업, 태그와 연결하고 청구 가능 여부를 설정하여 시간을 기록합니다.
도구: CLOCKIFY_CREATE_TIME_ENTRY
워크스페이스 64a687e3의 프로젝트 64a687e2에 오늘 UTC 9시부터 "API 개발" 설명과 함께 2시간 작업 기록
주요 파라미터:
workspaceId(필수) -- 항목이 생성될 워크스페이스start(필수) -- ISO 8601 시작 시간 (예:2026-02-11T09:00:00Z)end-- ISO 8601 종료 시간; 생략하면 실행 중인 타이머 생성projectId-- 프로젝트 연결taskId-- 작업 연결description-- 작업 설명 (0-3000자)tagIds-- 태그 ID 배열billable-- 청구 가능 여부customFieldValues--customFieldId와value를 포함한 사용자 정의 필드 항목 배열
2. 시간 항목 조회
보고, 감사 및 인보이스 발행을 위해 과거 시간 항목을 검색합니다.
도구: CLOCKIFY_GET_TIME_ENTRIES
워크스페이스 xyz789의 사용자 abc123에 대한 2026년 1월 전체 시간 항목 가져오기
주요 파라미터:
workspaceId(필수) -- 조회할 워크스페이스userId(필수) -- 항목을 검색할 사용자start/end-- ISO 8601 날짜 범위 필터project-- 프로젝트 ID로 필터링task-- 작업 ID로 필터링tags-- 쉼표로 구분된 태그 IDdescription-- 텍스트 필터 (부분 일치)hydrated--true로 설정하면 ID 대신 전체 프로젝트/작업/태그 객체 반환in-progress--true로 설정하면 실행 중인 타이머만 반환page/page-size-- 페이징 (기본값 50개)
3. 시간 항목 삭제
잘못된 항목, 중복 항목 또는 취소된 시간 항목을 제거합니다.
도구: CLOCKIFY_DELETE_TIME_ENTRY
워크스페이스 64a687e3에서 시간 항목 5b715448 삭제
workspaceId와id(시간 항목 ID) 필요- 잘못된 가져오기 또는 중복 항목 정리에 사용
4. 워크스페이스 관리
인증된 사용자가 속한 모든 워크스페이스를 나열합니다.
도구: CLOCKIFY_GET_ALL_MY_WORKSPACES
내 모든 Clockify 워크스페이스 보여줘
- 선택적
roles필터 --["WORKSPACE_ADMIN", "OWNER"]와 같은 역할 배열 - 항목을 만들거나 조회하기 전에 워크스페이스 ID를 확인하는 데 사용
5. 사용자 정보
현재 사용자 세부 정보를 검색하고 워크스페이스 멤버를 나열합니다.
도구: CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO, CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE
내가 누구로 로그인했는지 알려줘. 그런 다음 워크스페이스 64a687e3의 모든 사용자 나열
CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO는 인증된 사용자의 프로필을 반환합니다 (파라미터 불필요)CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE는workspaceId가 필요하며name,email필터와 페이징 (page,page-size최대 100)을 지원합니다.
6. 실행 중인 타이머 관리
생성 시 end를 생략하여 타이머를 시작하거나 실행 중인 항목을 확인합니다.
도구: CLOCKIFY_CREATE_TIME_ENTRY, CLOCKIFY_GET_TIME_ENTRIES
워크스페이스 xyz의 프로젝트 abc에 "버그 수정 중" 설명으로 타이머 시작
end없이 생성하면 실행 중인 타이머 시작CLOCKIFY_GET_TIME_ENTRIES를in-progress: true로 사용하여 타이머가 실행 중인지 확인
알려진 문제점
- 워크스페이스 및 사용자 ID 필수: 대부분의 Clockify 도구는
workspaceId와userId가 모두 필요합니다. 항상 먼저CLOCKIFY_GET_ALL_MY_WORKSPACES와CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO를 호출하여 이러한 ID를 확인하세요. - ISO 8601 타임스탬프: 모든 시간 파라미터는 시간대가 포함된 ISO 8601 형식(예:
2026-02-11T09:00:00Z)이어야 합니다. 시간대를 생략하면 예측할 수 없는 동작이 발생합니다. - 실행 중인 타이머: 한 번에 하나의 타이머만 실행할 수 있습니다. 다른 타이머가 이미 활성화된 상태에서
end없이 새 항목을 생성하면 실패합니다. 먼저 기존 타이머를 중지하세요. - 페이징 기본값:
CLOCKIFY_GET_TIME_ENTRIES는 기본적으로 페이지당 50개 항목을 반환합니다. 전체 내보내기를 위해서는 더 이상 결과가 반환되지 않을 때까지 페이지를 반복하세요. - 태그 ID는 워크스페이스 범위: 한 워크스페이스의 태그 ID는 다른 워크스페이스에서 사용할 수 없습니다. 항상 대상 워크스페이스 컨텍스트 내에서 태그를 확인하세요.
빠른 참조
| 도구 Slug | 설명 |
|---|---|
CLOCKIFY_CREATE_TIME_ENTRY | 시간 항목 생성 또는 타이머 시작 (workspaceId, start 필요) |
CLOCKIFY_GET_TIME_ENTRIES | 필터와 함께 시간 항목 목록 조회 (workspaceId, userId 필요) |
CLOCKIFY_DELETE_TIME_ENTRY | 시간 항목 삭제 (workspaceId, id 필요) |
CLOCKIFY_GET_ALL_MY_WORKSPACES | 인증된 사용자의 모든 워크스페이스 나열 |
CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO | 현재 사용자 프로필 정보 가져오기 |
CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE | 워크스페이스의 모든 사용자 나열 (workspaceId 필요) |
Composio 제공