Timelog MCP Server

MCP 서버로, Timelog 시간 등록 API를 Claude용 도구로 노출합니다. 자연어로 시간 등록, 부재, 타임시트 승인을 조회, 생성, 관리할 수 있습니다.

기능

• 시간 등록 조회 — 주간 또는 임의의 날짜 범위로 조회, 재무/청구 가능 데이터 포함

• 시간 등록 생성, 수정, 삭제 — 액세스 권한이 있는 모든 작업에 대해

• 부재 관리 — 부재 코드를 검색하고 휴가, 병가 등을 등록

• 타임시트 승인 — 제출 상태 확인 및 타임시트 제출, 직원, 부서, 승인자 또는 법인으로 필터링

• 조직 — 법인 및 현재 사용자 프로필 조회

• 작업 검색 — 이름 또는 번호로 시간을 등록할 작업 찾기

Related MCP server: TimeChimp MCP Server

도구

사용자 및 조직

get_current_user

인증된 사용자의 프로필(이름, 이메일, 부서)을 가져옵니다. 매개변수가 없습니다.

get_legal_entities

조직의 모든 법인을 가져옵니다. 각 법인의 ID, 이름, 활성 상태, 통화 및 국가를 반환합니다. 매개변수가 없습니다.

시간 등록

get_weekly_registrations

특정 주의 시간 등록을 표준 시간과 함께 요일별로 그룹화하여 가져옵니다.

get_registrations_by_date_range

두 날짜 사이의 시간 등록을 가져옵니다.

get_financial_data

날짜 범위의 시간 등록에 대한 재무 데이터(청구 가능/청구 상태)를 가져옵니다.

search_tasks

사용자가 시간을 등록할 수 있는 작업을 검색합니다. 시간 등록 생성에 필요한 작업 ID를 반환합니다.

create_time_registration

작업에 새 시간 등록을 생성합니다. TaskID를 찾으려면 먼저 search_tasks를 사용하세요.

update_time_registration

기존 시간 등록을 업데이트합니다. 변경하려는 필드만 입력하세요.

delete_time_registration

GUID로 시간 등록을 삭제합니다.

부재

search_absence_codes

부재 코드(예: Ferie, Sygdom)를 검색합니다. create_absence_registration에 필요한 AbsenceCodeID를 반환합니다.

create_absence_registration

부재 등록(휴가, 병가 등)을 생성합니다. AbsenceCodeID를 찾으려면 search_absence_codes를 사용하세요. 기본적으로 전체 근무일을 등록합니다.

타임시트 승인

get_timesheet_status

주간 타임시트 승인/제출 상태를 가져옵니다. 기본값은 인증된 사용자입니다. 모든 직원을 조회하려면(관리자 보기) userId를 생략하세요.

submit_timesheet

날짜 범위(예: 전체 주)에 대한 타임시트를 승인 요청으로 제출합니다.

관리자 워크플로

미제출 타임시트 찾기 및 마감

userId 없이 get_timesheet_status를 사용하여 특정 기간의 모든 직원 제출 상태를 가져옵니다. departmentId, approverId 또는 legalEntityId로 필터링하여 범위를 좁힐 수 있습니다.

미제출 타임시트가 있는 직원을 확인한 후 employeeUserId와 함께 submit_timesheet를 사용하여 해당 직원을 대신해 제출하세요.

예시 프롬프트:

"이번 주 타임시트를 제출하지 않은 모든 사람을 보여줘" "사용자 1234의 이번 주 타임시트 제출" "이번 주 부서 5의 모든 미제출 타임시트 제출"

설정

npx로 설치 (권장)

Claude Code .mcp.json 또는 Claude Desktop 구성에 추가하세요:

{
  "mcpServers": {
    "timelog": {
      "command": "npx",
      "args": ["-y", "timelog-mcp"],
      "env": {
        "TIMELOG_PAT": "<your-personal-access-token>",
        "TIMELOG_BASE_URL": "https://app[X].timelog.com/<your-account>/api"
      }
    }
  }
}

소스에서 설치

git clone git@github.com:Amoeslund/Timelog-MCP-server.git
cd Timelog-MCP-server
npm install
npm run build

그런 다음 MCP 구성이 빌드된 파일을 가리키도록 하세요:

{
  "mcpServers": {
    "timelog": {
      "command": "node",
      "args": ["/path/to/Timelog-MCP-server/dist/index.js"],
      "env": {
        "TIMELOG_PAT": "<your-personal-access-token>",
        "TIMELOG_BASE_URL": "https://app[X].timelog.com/<your-account>/api"
      }
    }
  }
}

구성

개인 액세스 토큰

다음에서 PAT를 생성하세요: https://login.timelog.com/personaltoken.

기본 URL

URL 패턴은 https://app[X].timelog.com/<your-account>/api이며, [X]는 서버 번호(1–10), <your-account>는 Timelog 계정 이름입니다. 자세한 내용은 Timelog API 문서를 참조하세요.

환경 변수

라이선스

ISC