Toggl Automation
Claude Code에서 직접 Toggl Track 시간 추적 작업을 자동화하세요. 시간을 기록하고, 프로젝트와 클라이언트를 관리하며, 태그로 분류하고, 워크스페이스를 제어할 수 있습니다 — 터미널을 떠날 필요 없이.
툴킷 문서: composio.dev/toolkits/toggl
설정
- Claude Code 설정에 URL
https://rube.app/mcp를 사용하여 Rube MCP 서버를 추가합니다. - 메시지가 표시되면 제공된 연결 링크를 통해 Toggl Track 계정을 인증합니다.
- 자연어 명령어로 시간 추적 워크플로우를 자동화하기 시작합니다.
핵심 워크플로우
1. 시간 항목 생성 및 중지
프로젝트, 작업, 태그와 연결하여 시간을 기록하거나 타이머를 시작/중지합니다.
도구: TOGGL_CREATE_TIME_ENTRY, TOGGL_PATCH_STOP_TIME_ENTRY
워크스페이스 123456에서 프로젝트 78910에 대해 "회의" 및 "디자인" 태그가 붙은 설명 "디자인 리뷰 세션"으로 시간 항목을 시작해줘
TOGGL_CREATE_TIME_ENTRY의 주요 매개변수:
workspace_id(필수) — 대상 워크스페이스created_with(필수) — 클라이언트 애플리케이션 이름 (예:"api_client")start(필수) — ISO 8601 타임스탬프stop— ISO 8601 종료 시간; 생략하면 항목이 계속 실행됨duration— 초 단위 기간; 실행 중인 항목의 경우 생략project_id— 프로젝트 연결task_id— 작업 연결tags— 태그 이름 문자열의 배열 (ID 아님)description— 작업 설명billable— 청구 가능 여부
TOGGL_PATCH_STOP_TIME_ENTRY의 주요 매개변수:
workspace_id(필수) 및time_entry_id(필수)
2. 프로젝트 관리
새 프로젝트를 생성하고 클라이언트 정보와 페이지네이션을 포함한 기존 프로젝트를 조회합니다.
도구: TOGGL_CREATE_PROJECT, TOGGL_GET_PROJECTS, TOGGL_GET_PROJECT_DETAILS
워크스페이스 123456에 클라이언트 78910을 위해 "Q1 마케팅 캠페인"이라는 비공개 청구 가능 프로젝트를 생성해줘
TOGGL_CREATE_PROJECT의 주요 매개변수:
workspace_id(필수) 및name(필수)client_id,billable,is_private,active,colorestimated_hours,rate,fixed_fee,currency(프리미엄 기능)
TOGGL_GET_PROJECTS의 주요 매개변수:
workspace_id(필수)page/page_size(1-200) 페이지네이션since/until— 수정 필터링을 위한 Unix 타임스탬프 (최근 3개월만)clients: true전체 클라이언트 정보 포함
3. 클라이언트 관리
워크스페이스 내에서 클라이언트를 생성하고 조회합니다.
도구: TOGGL_CREATE_CLIENT, TOGGL_GET_LIST_CLIENTS
워크스페이스 123456의 모든 활성 클라이언트를 조회한 다음, "Acme Corp"라는 새 클라이언트를 생성해줘
TOGGL_CREATE_CLIENT는workspace_id와name이 필요하며;notes,external_reference를 받습니다.TOGGL_GET_LIST_CLIENTS는workspace_id가 필요하며;status("active","archived","both") 및name(대소문자 구분 없는 검색)을 지원합니다.
4. 태그 및 워크스페이스 설정
분류를 위한 태그를 검색하고 워크스페이스 설정을 확인합니다.
도구: TOGGL_GET_TAGS, TOGGL_GET_WORKSPACE_PREFERENCES
워크스페이스 123456의 모든 태그와 워크스페이스 설정을 보여줘
TOGGL_GET_TAGS는workspace_id가 필요하며; 태그 ID와 이름을 반환합니다.TOGGL_GET_WORKSPACE_PREFERENCES는workspace_id가 필요하며; 요금제 및 표시 설정을 반환합니다.
5. 워크스페이스 탐색
인증된 사용자가 속한 모든 워크스페이스를 조회합니다.
도구: TOGGL_GET_USER_WORKSPACES
내가 접근할 수 있는 Toggl 워크스페이스는 무엇인가요?
- 매개변수가 필요하지 않습니다.
- 모든 워크스페이스와 ID, 이름, 메타데이터를 반환합니다.
- 다른 작업을 위해 워크스페이스 ID를 찾으려면 먼저 이 도구를 사용하세요.
6. 사용자 프로젝트 가시성
인증된 사용자에게 표시되는 프로젝트를 조회합니다.
도구: TOGGL_GET_USER_PROJECTS
내 워크스페이스 전반에서 내가 볼 수 있는 모든 프로젝트를 보여줘
- 인증된 사용자가 접근할 수 있는 프로젝트를 반환합니다.
- 워크스페이스 범위의 보기를 위해
TOGGL_GET_PROJECTS와 함께 사용하세요.
알려진 문제점
- 태그는 ID가 아닌 이름을 사용합니다:
TOGGL_CREATE_TIME_ENTRY는 많은 API가 ID를 사용하는 것과 달리tags배열에 문자열로 된 태그 이름을 받습니다. 사용 가능한 태그 이름을 확인하려면TOGGL_GET_TAGS를 사용하세요. created_with는 필수입니다: 모든 시간 항목에는created_with(예:"api_client")가 포함되어야 합니다. 이 필드가 누락되면 조용히 실패합니다.- 기간은 초 단위입니다: 시간 항목의
duration매개변수는 시간이 아니라 초 단위입니다. 1시간 = 3600초입니다. since타임스탬프 제한:TOGGL_GET_PROJECTS의since필터는 최근 3개월 이내의 타임스탬프만 허용합니다. 더 오래된 쿼리는 거부됩니다.- 프리미엄 기능 차단: 프로젝트의 사용자 정의 색상, 템플릿, 고정 요금 및 시간당 요금은 프리미엄 Toggl 요금제가 필요합니다. 비프리미엄 계정에서 이러한 필드를 사용하면 오류가 발생합니다.
- 워크스페이스 ID는 모든 곳에서 필요합니다: 거의 모든 Toggl 도구에는
workspace_id가 필요합니다. 항상 먼저TOGGL_GET_USER_WORKSPACES를 호출하여 워크스페이스 ID를 확인하세요.
빠른 참조
| 도구 Slug | 설명 |
|---|---|
TOGGL_CREATE_TIME_ENTRY | 시간 항목 또는 실행 중인 타이머를 생성합니다 (workspace_id, created_with, start 필요) |
TOGGL_PATCH_STOP_TIME_ENTRY | 실행 중인 시간 항목을 중지합니다 (workspace_id, time_entry_id 필요) |
TOGGL_GET_PROJECTS | 페이지네이션으로 워크스페이스의 프로젝트를 조회합니다 |
TOGGL_GET_PROJECT_DETAILS | 특정 프로젝트의 세부 정보를 가져옵니다 |
TOGGL_CREATE_PROJECT | 새 프로젝트를 생성합니다 (workspace_id, name 필요) |
TOGGL_GET_LIST_CLIENTS | 상태/이름 필터로 클라이언트를 조회합니다 (workspace_id 필요) |
TOGGL_CREATE_CLIENT | 새 클라이언트를 생성합니다 (workspace_id, name 필요) |
TOGGL_GET_TAGS | 워크스페이스의 모든 태그를 조회합니다 (workspace_id 필요) |
TOGGL_GET_WORKSPACE_PREFERENCES | 워크스페이스 설정을 가져옵니다 (workspace_id 필요) |
TOGGL_GET_USER_WORKSPACES | 인증된 사용자의 모든 워크스페이스를 조회합니다 |
TOGGL_GET_USER_PROJECTS | 인증된 사용자에게 표시되는 프로젝트를 조회합니다 |
Composio 제공