Timelog MCP サーバー

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

機能

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

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

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

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

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

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

Related MCP server: TimeChimp MCP Server

ツール

ユーザーと組織

get_current_user

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

get_legal_entities

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

時間登録

get_weekly_registrations

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

get_registrations_by_date_range

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

get_financial_data

日付範囲内の時間登録に関する財務データ（請求可能／請求ステータス）を取得します。

search_tasks

ユーザーが時間登録できるタスクを検索します。時間登録の作成に必要なタスク ID を返します。

create_time_registration

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

update_time_registration

既存の時間登録を更新します。変更したいフィールドのみを指定してください。

delete_time_registration

GUID で時間登録を削除します。

欠勤

search_absence_codes

欠勤コード（例: Ferie、Sygdom）を検索します。create_absence_registration に必要な AbsenceCodeID を返します。

create_absence_registration

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

タイムシート承認

get_timesheet_status

週次のタイムシート承認・提出状況を取得します。既定では認証済みユーザーを対象とします。userId を省略すると全従業員を取得します（マネージャー表示）。

submit_timesheet

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

マネージャーワークフロー

未提出タイムシートの検索と提出

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 ドキュメント を参照してください。

環境変数

ライセンス

ISC