Skip to main content
Glama

Timelog MCP サーバー

Timelog の時間登録 API を Claude のツールとして公開する MCP サーバーです。自然言語で時間登録、欠勤、タイムシート承認の閲覧・作成・管理ができます。

機能

  • 時間登録の閲覧 — 週単位または任意の日付範囲で、財務・請求可能データを含めて表示

  • 時間登録の作成・更新・削除 — アクセス権のある任意のタスクに対して実行可能

  • 欠勤管理 — 欠勤コードの検索と、休暇・病気休暇などの登録

  • タイムシート承認 — 提出状況の確認とタイムシートの提出。従業員、部門、承認者、法人で絞り込み可能

  • 組織 — 法人と現在のユーザープロフィールの参照

  • タスク検索 — 名前または番号で時間登録対象のタスクを検索

Related MCP server: Tripletex MCP Server

ツール

ユーザーと組織

get_current_user

認証済みユーザーのプロフィール(名前、メールアドレス、部門)を取得します。パラメータなし。

組織内のすべての法人を取得します。各法人の ID、名前、有効ステータス、通貨、国を返します。パラメータなし。

時間登録

get_weekly_registrations

特定の週の時間登録を、基準時間付きで日ごとにグループ化して取得します。

パラメータ

型

必須

説明

startDate

string

はい

その週の月曜日(YYYY-MM-DD)

get_registrations_by_date_range

2 つの日付の間の時間登録を取得します。

パラメータ

型

必須

説明

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

タスクに新しい時間登録を作成します。まず search_tasks を使用して TaskID を検索してください。

パラメータ

型

必須

説明

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

欠勤登録(休暇、病気休暇など)を作成します。search_absence_codes を使用して AbsenceCodeID を検索してください。既定では勤務日 1 日分を登録します。

パラメータ

型

必須

説明

AbsenceCodeID

integer

はい

欠勤コード識別子(search_absence_codes から取得)

Date

string

はい

欠勤日(YYYY-MM-DD)

Hours

number

いいえ

登録する時間数(勤務日 1 日分の場合は省略)

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

日付範囲(例: 1 週間全体)のタイムシートを承認用に提出します。

パラメータ

型

必須

説明

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"
      }
    }
  }
}

設定

個人アクセストークン

https://login.timelog.com/personaltoken で PAT を生成します。

ベース 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
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers