Skip to main content
Glama

Timelog MCP Server

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

기능

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

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

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

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

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

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

Related MCP server: Tripletex MCP Server

도구

사용자 및 조직

get_current_user

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

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

시간 등록

get_weekly_registrations

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

매개변수

유형

필수

설명

startDate

string

예

해당 주의 월요일 (YYYY-MM-DD)

get_registrations_by_date_range

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

매개변수

유형

필수

설명

startDate

string

예

시작 날짜 (YYYY-MM-DD)

endDate

string

예

종료 날짜 (YYYY-MM-DD)

get_financial_data

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

매개변수

유형

필수

설명

startDate

string

예

시작 날짜 (YYYY-MM-DD)

endDate

string

예

종료 날짜 (YYYY-MM-DD)

search_tasks

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

매개변수

유형

필수

설명

searchText

string

아니요

검색할 작업 이름 또는 작업 번호

searchAll

boolean

아니요

최근 작업뿐만 아니라 모든 작업 검색 (기본값: false)

create_time_registration

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

매개변수

유형

필수

설명

TaskID

integer

예

작업 식별자 (search_tasks에서)

Date

string

예

등록 날짜 (YYYY-MM-DD)

Hours

number

예

등록할 시간 수

Comment

string

아니요

등록에 대한 설명

JiraId

string

아니요

JIRA 티켓 ID (예: XXX-1234)

Billable

boolean

아니요

이 시간이 청구 가능한지 여부 (기본값은 작업 설정)

update_time_registration

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

매개변수

유형

필수

설명

TimeRegistrationID

integer

예

업데이트할 시간 등록 ID

TaskID

integer

예

작업 식별자

Date

string

아니요

새 날짜 (YYYY-MM-DD)

Hours

number

아니요

새 시간 값

Comment

string

아니요

새 설명

JiraId

string

아니요

JIRA 티켓 ID (예: SGI-82108)

Billable

boolean

아니요

이 시간이 청구 가능한지 여부

delete_time_registration

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

매개변수

유형

필수

설명

id

string (UUID)

예

삭제할 시간 등록의 GUID

부재

search_absence_codes

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

매개변수

유형

필수

설명

searchText

string

아니요

부재 코드 이름 또는 번호로 필터링

create_absence_registration

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

매개변수

유형

필수

설명

AbsenceCodeID

integer

예

부재 코드 식별자 (search_absence_codes에서)

Date

string

예

부재 날짜 (YYYY-MM-DD)

Hours

number

아니요

등록할 시간 (전체 근무일이면 생략)

Comment

string

아니요

등록에 대한 설명

타임시트 승인

get_timesheet_status

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

매개변수

유형

필수

설명

startDate

string

예

시작 날짜 (YYYY-MM-DD)

endDate

string

예

종료 날짜 (YYYY-MM-DD)

userId

integer

아니요

직원 UserID로 필터링 (모든 직원이면 생략)

departmentId

integer

아니요

부서 ID로 필터링

approverId

integer

아니요

승인자 UserID로 필터링

legalEntityId

integer

아니요

법인 ID로 필터링

submit_timesheet

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

매개변수

유형

필수

설명

startDate

string

예

시작 날짜 (YYYY-MM-DD)

endDate

string

예

종료 날짜 (YYYY-MM-DD)

comment

string

아니요

제출에 대한 설명

employeeUserId

integer

아니요

제출 대상 직원의 UserID (기본값은 인증된 사용자)

관리자 워크플로

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

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 문서를 참조하세요.

환경 변수

변수

필수

설명

TIMELOG_PAT

예

개인 액세스 토큰 (위 참조)

TIMELOG_BASE_URL

예

API 기본 URL (위 참조)

라이선스

ISC

Available Tools

21 tools
create_absence_registrationA

Create an absence registration (e.g. vacation, sick leave). Use search_absence_codes to find the AbsenceCodeID. Registers a full day by default; specify Hours for partial days.

Inputs: Date (required), AbsenceCodeID (required), Hours, Comment.

create_taskB

Create a new task (phase) on a project. Use search_projects to find the ProjectID first.

Inputs: EndDate (required), TaskName (required), ProjectID (required), StartDate (required), +7 more.

create_time_registrationA

Create a new time registration on a task. Use search_tasks first to find the TaskID.

Inputs: Date (required), Hours (required), TaskID (required), JiraId, +2 more.

delete_time_registrationB

Delete a time registration by its GUID.

Inputs: id (required).

get_contract_hourly_ratesA

Get all hourly rates configured on a specific contract. Returns rate name (role), amount, currency, type, and active status. Use get_project_contracts first to find the contractId.

Inputs: contractId (required).

get_current_userA

Get the currently authenticated Timelog user (name, email, department).

Inputs: no named parameters.

get_financial_dataB

Get financial data (billable/invoice status) for time registrations in a date range.

Inputs: endDate (required), startDate (required).

get_fixed_price_contract_detailsA

Get complete details for a fixed-price contract: contract value (from payment plan), payment schedule, linked fixed-price tasks/phases, and configured hourly rates. The contract value is the total price agreed with the client. For FP contracts, hourly rates are typically 0 (billing isn't per-hour) — use the overall project financial data to compute effective rates.

Inputs: projectId (required), contractId (required).

get_hourly_ratesA

Get hourly rates defined in Timelog. Returns rate name, amount, currency, customer, and active status. Use searchText to filter by name. Results are paginated.

Inputs: pageSize, pageNumber, searchText.

get_projectA

Get project details by project ID. Returns name, project number, customer, project manager, budget, dates, and type.

Inputs: projectId (required).

get_project_contractsA

Get all contracts for a project. Returns contract ID, name, type (Fixed Price / Time & Material), status, and whether it's the main contract. Use the contractId with get_contract_hourly_rates to see rates.

Inputs: projectId (required).

get_project_tasksA

Get all tasks (phases) for a project. Returns task IDs, names, parent hierarchy, fixed-price status, and billable defaults. Use the projectId from get_project or from time registrations.

Inputs: projectId (required), pageSize, pageNumber.

get_registrations_by_date_rangeB

Get time registrations between two dates.

Inputs: endDate (required), startDate (required).

get_timesheet_statusB

Get weekly timesheet status. Defaults to the authenticated user. Pass userId to check a specific employee, or omit to get all employees (manager view). Can also filter by departmentId, approverId, or legalEntityId.

Inputs: endDate (required), startDate (required), userId, approverId, +2 more.

get_weekly_registrationsA

Get time registrations for a specific week. Provide the Monday date of the week.

Inputs: startDate (required).

search_absence_codesA

Search for absence codes (e.g. Ferie, Sygdom). Returns AbsenceCodeID needed for create_absence_registration.

Inputs: searchText.

search_projectsA

Search for projects by name or number. Returns project IDs, names, numbers, and customer info.

Inputs: searchText.

search_tasksA

Search for tasks the user can register time on. Returns task IDs needed for creating time registrations. Use searchText to filter by task or project name.

Inputs: searchAll, searchText.

submit_timesheetB

Submit timesheet for approval for a date range (e.g. a full week).

Inputs: endDate (required), startDate (required), comment, employeeUserId.

update_time_registrationA

Update an existing time registration (hours, comment, date, billable status).

Inputs: TaskID (required), TimeRegistrationID (required), Date, Hours, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools target distinct resources (time registrations, absence, projects, contracts, rates), but there is potential overlap between get_weekly_registrations and get_registrations_by_date_range, and between get_hourly_rates and get_contract_hourly_rates. Descriptions clarify the differences, so only minor confusion risk exists.

    Naming Consistency5/5

    All tools follow a consistent verb_noun snake_case pattern (e.g., get_project, create_time_registration, search_tasks, update_time_registration, submit_timesheet). The naming convention is uniform and predictable, with no mixed styles or vague verbs.

    Tool Count4/5

    21 tools is on the higher end but appropriate for a comprehensive time tracking and project management domain. The server covers time registration, absence, projects, contracts, rates, financials, and users, so the tool count is justified without being bloated.

    Completeness4/5

    The tool surface covers core CRUD for time registrations, timesheet submission and status, project and task search, contract and rate queries, and financial data. Minor gaps exist, such as lack of update/delete for absence registrations and no direct query for absence registrations, but these are workable.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers