Skip to main content
Glama
deenesjakoruzh
ficus33

TrackingTime MCP Server

by ficus33
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

TrackingTime MCPサーバー

MCP (Model Context Protocol)サーバーであり、ClaudeのようなAIアシスタントをTrackingTime API v4に接続します。プロジェクト、タスク、時間追跡、スタッフの割り当て、顧客を自然言語で管理できます。

クイックスタート

1. TrackingTimeの認証情報を取得する

  • アプリパスワード: TrackingTime → 管理 → ユーザー設定 → アプリと統合 → 新しいアプリパスワードを作成

  • アカウントID: ログイン時のTrackingTime URL、またはアカウント設定で確認可能

2. AIアシスタントに追加する

Claude Code:

claude mcp add trackingtime -e TT_APP_PASSWORD=your-app-password -e TT_ACCOUNT_ID=your-account-id -- npx trackingtime-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "trackingtime": {
      "command": "npx",
      "args": ["trackingtime-mcp"],
      "env": {
        "TT_APP_PASSWORD": "your-app-password",
        "TT_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

追加後、アシスタントを再起動してください。

代替手段: ソースからインストール

クローンしてローカルでビルドする場合:

git clone https://github.com/ficus33/trackingtime-mcp.git
cd trackingtime-mcp
npm install
npm run build
cp .env.example .env   # then edit .env with your credentials

その後、アシスタントにローカルビルドを指定します:

claude mcp add trackingtime -- node /path/to/trackingtime-mcp/dist/index.js

Related MCP server: Clockify MCP Server

ツール

プロジェクト

ツール

説明

tt_list_projects

プロジェクトを一覧表示 (フィルター: ACTIVE/ARCHIVED/ALL/FOLLOWING)

tt_list_project_ids

プロジェクトIDのみを一覧表示 (軽量、バッチ処理用)

tt_search_projects

キーワードでプロジェクトとタスクを検索

tt_create_project

新しいプロジェクトを作成

tt_update_project

プロジェクト名、顧客、またはサービスを編集

tt_update_project_preferences

お気に入り、デフォルトビュー、完了タスクの表示を設定

tt_get_project

詳細フラグ付きで単一のプロジェクトを取得

tt_get_project_times

複数のプロジェクトの累積時間を取得

tt_get_project_users

プロジェクトに割り当てられているスタッフを確認

tt_archive_project

プロジェクトをアーカイブ (元に戻せます)

tt_reopen_project

アーカイブされたプロジェクトを再開

tt_delete_project

プロジェクトを完全に削除

tt_merge_projects

プロジェクトを別のプロジェクトに統合

タスク

ツール

説明

tt_list_tasks

タスクを一覧表示 (フィルター: ACTIVE/ARCHIVED/ALL/TRACKING)

tt_create_task

担当者、期限、見積もり時間を指定してタスクを作成

tt_update_task

タスクを編集またはスタッフを再割り当て

tt_get_task

単一のタスク詳細を取得

tt_get_task_times

複数のタスクの累積時間を取得

tt_search_tasks

プロジェクト内のタスクを名前で検索

tt_sort_tasks

ソートインデックスでタスクを並べ替え

tt_import_tasks

プレビューモードでタスクを一括インポート

tt_close_task

タスクを完了としてマーク

tt_reopen_task

完了したタスクを再開

tt_delete_task

タスクを削除

時間追跡

ツール

説明

tt_start_timer

タスクのタイマーを開始

tt_stop_timer

実行中のタイマーを停止

時間入力

ツール

説明

tt_list_time_entries

ユーザー/プロジェクト/顧客/タスク + 日付範囲でエントリを一覧表示

tt_list_time_entries_min

軽量な最小リスト (請求済みフィルター、休暇)

tt_count_time_entries

フィルターごとのエントリ数を高速カウント

tt_add_time_entry

手動で時間エントリを追加 (秒単位の期間)

tt_get_time_entry

単一の時間エントリを取得

tt_update_time_entry

時間エントリを編集

tt_delete_time_entry

時間エントリを削除

tt_get_events_summary

ユーザーごとの日次時間集計

tt_export_time_entries

CSVとしてエクスポート

tt_mark_billed

エントリを請求済みとしてフラグ付け

tt_mark_not_billed

請求済みフラグを解除

イベントタグ

ツール

説明

tt_list_tags

すべてのタグ定義を一覧表示

tt_get_tag

単一のタグを取得

tt_list_tag_values

タグ名に使用されている値を一覧表示

tt_create_tag

タグ定義を作成

tt_update_tag

タグを更新

tt_delete_tag

タグ定義を削除

tt_save_event_tag

時間エントリにタグを付与/更新

tt_delete_event_tag

時間エントリからタグを削除

ユーザーとスタッフ

ツール

説明

tt_list_users

すべてのスタッフを一覧表示 (ユーザーIDの検索)

tt_get_user

単一のユーザー詳細を取得

tt_create_user

ユーザーを作成 (削除された tt_invite_users を置き換え)

tt_update_user

ユーザープロフィールを更新

tt_update_user_permissions

詳細な編集/閲覧権限を設定

tt_update_employee

人事フィールドを更新 (役職、部署、日付など)

tt_resend_invite

保留中のユーザーにアクティベーションメールを再送

tt_reset_icalendar_token

ユーザーのiCalエクスポートトークンをローテーション

tt_get_user_tasks

プロジェクトごとにグループ化されたユーザーのタスクを一覧表示

tt_get_user_tracking

ユーザーが現在追跡している内容を確認

tt_get_user_trackables

ユーザーに割り当てられたすべてのプロジェクトとタスク

tt_get_user_projects

ユーザーに割り当てられたプロジェクトを一覧表示

tt_assign_user_projects

スタッフをプロジェクトに割り当て

tt_remove_user_projects

プロジェクトからスタッフを削除

tt_archive_user

ユーザーを非アクティブ化 (管理者のみ)

tt_reactivate_user

アーカイブされたユーザーを再アクティブ化

ユーザーグループ

ツール

説明

tt_list_user_groups

グループを一覧表示 (フィルター: ACTIVE/ARCHIVED/ALL)

tt_get_user_group

単一のグループを取得

tt_create_user_group

グループを作成 (スーパーバイザーとメンバーが必要)

tt_update_user_group

グループを更新 (status: "ARCHIVED" でアーカイブ)

tt_delete_user_group

グループを完全に削除

顧客

ツール

説明

tt_list_customers

顧客を一覧表示 (フィルター: ACTIVE/ARCHIVED/ALL)

tt_get_customer

単一の顧客詳細を取得

tt_create_customer

新しい顧客を作成

tt_update_customer

顧客詳細を編集

tt_delete_customer

顧客を完全に削除

tt_archive_customer

顧客をアーカイブ (元に戻せます)

tt_reactivate_customer

アーカイブされた顧客を再アクティブ化

サービス

ツール

説明

tt_list_services

サービス (作業カテゴリ) を一覧表示

tt_get_service

サービスを取得

tt_create_service

新しいサービスを作成

tt_update_service

サービスを更新

tt_archive_service

サービスをアーカイブ (元に戻せます)

tt_reactivate_service

アーカイブされたサービスを再アクティブ化

tt_delete_service

サービスを完全に削除

チーム (ワークスペース)

ツール

説明

tt_list_teams

ユーザーが所属するすべてのワークスペースを一覧表示

tt_switch_team

セッションのアクティブなワークスペースを切り替え

tt_update_team_permissions

デフォルトのメンバー権限を更新

レポート

ツール

説明

tt_get_user_report

チャートと内訳を含むユーザーごとの分析レポート

通知

ツール

説明

tt_list_notifications

通知を一覧表示 (USERまたはPROJECTスコープ)

tt_mark_notification_read

通知を既読としてマーク

tt_mark_notifications_read

複数の通知を既読としてマーク

Webhook

ツール

説明

tt_list_webhooks

設定済みのWebhookを一覧表示

tt_get_webhook

Webhookを取得

tt_enable_webhook

Webhookを有効化

tt_disable_webhook

Webhookを無効化

tt_reset_webhook_token

Webhookの署名トークンをローテーション

tt_delete_webhook

Webhookを削除

ツール数の削減

93個のツールすべてがデフォルトで有効になっています。AIアシスタントにとってコンテキストが多すぎると感じる場合は、リポジトリをクローンし、src/tools.ts 内で不要なツールを /* */ でコメントアウトし、npm run build を実行して軽量なビルドを作成してください。

テスト

MCP Inspector を使用してツールを対話的にテストします:

npx @modelcontextprotocol/inspector npx trackingtime-mcp

APIに関する注意点

TrackingTime APIのいくつかの癖に注意してください:

  • duration と accumulated_time は 秒 単位です

  • estimated_time と worked_hours は 時間 単位です

  • 時間エントリはAPIでは「イベント」と呼ばれます

  • タイマーが既に実行されている状態でタイマーを開始するとエラー502が返されます — stop_running_task=true を使用して現在のタイマーを自動停止してください

  • 日付は YYYY-MM-DD、日時は yyyy-MM-dd HH:mm:ss を使用します

認証

このサーバーはTrackingTimeの アプリパスワード 認証を使用します。実際のパスワードが保存されることはありません。アプリパスワードはSSL経由でHTTPベーシック認証 (API_TOKEN:<app_password>) として送信されます。

アプリパスワードが漏洩した場合は、TrackingTimeで取り消して新しいものを作成してください。アカウントパスワードを変更する必要はありません。

ライセンス

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers