Timesheet

Timesheet MCP サーバー

ChatGPT、Claude、Claude Code、Cursor、VS Code などの AI アシスタントから、自然言語で Timesheet を操作できます。タイマーの開始と停止、過去の作業の記録、統計やエクスポートの取得、休暇の申請、プロジェクトやチームの管理をチャットで行えます。

このサーバーは、現在の Model Context Protocol（2026-07-28）とそれ以前のバージョンに対応しているため、新旧どちらのクライアントでも動作します。詳しいガイドは docs.timesheet.io をご覧ください。

接続方法は 2 通り

	ホスト型サーバー	ローカルサーバー
アドレス	https://mcp.timesheet.io	お使いのコンピューター上で npx -y @timesheet/mcp を実行
サインイン	Timesheet アカウント（OAuth 2.1）または API キー	API キー
必要条件	なし	Node.js 20 以降

どちらも同じツールを利用できます。API アクセスが含まれる Timesheet Pro 以上のプランが必要です。

API キーを取得する

Timesheet のウェブアプリで、Integrations > API Keys に移動し、New API Key を選択してキーをコピーします。同じキーをホスト型サーバー、ローカルサーバー、および Timesheet API で使用できます。

ホスト型サーバーを使用する

ChatGPT： 開発者モードを有効にし、URL https://mcp.timesheet.io を使って接続を追加します。求められたら Timesheet アカウントでサインインしてください。

Claude Code（API キーを使用）：

claude mcp add --transport http --scope user timesheet https://mcp.timesheet.io --header "Authorization: Bearer your-api-token-here"

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "timesheet": {
      "url": "https://mcp.timesheet.io",
      "headers": { "Authorization": "Bearer your-api-token-here" }
    }
  }
}

ローカルサーバーを使用する

Claude Code：

claude mcp add timesheet --scope user -e TIMESHEET_API_TOKEN=your-api-token-here -- npx -y @timesheet/mcp

Claude Desktop（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）、および同じ形式を使用するその他のクライアント：

{
  "mcpServers": {
    "timesheet": {
      "command": "npx",
      "args": ["-y", "@timesheet/mcp"],
      "env": {
        "TIMESHEET_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

設定を変更した後は、クライアントを再起動してください。ガイドで、VS Code やその他のクライアントのセットアップ方法を確認できます。

プロンプトの例

• 「ウェブサイトのプロジェクトのタイマーを開始して」
• 「タイマーを一時停止して。昼食にします」、続けて「タイマーを停止して」
• 「月曜日の API プロジェクトに 2 時間分を記録して」
• 「昨日は何に取り組んだ？」
• 「9 月に記録した請求対象時間は何時間？」
• 「Acme の 9 月のタイムシートを PDF にして [email protected] にメールで送って」
• 「来週の金曜日を休みにして」
• 「今、チームの誰が時間を記録している？」

ツール

このサーバーは 100 種類以上のツールを提供します。適切なツールはアシスタントが選ぶため、ツール名を指定する必要はありません。

分野	ツールの機能
タイマー	実行中のタイマーの開始、一時停止、再開、停止、編集
時間エントリー	エントリーの一覧表示、作成、更新、削除、メモ、経費、休憩の追加
統計	最長 1 年分の合計、請求対象時間、プロジェクト別・日別の内訳
レポートとエクスポート	Excel、CSV、PDF へのエクスポート、エクスポート用テンプレート、ドキュメント、タスク、経費、メモの PDF
プロジェクト、ToDo、タグ	プロジェクトとそのメンバー、ToDo、タグ、料金の管理
休暇と契約	休暇の申請、承認、取り消し、休暇の種類と契約の管理
チームと組織	メンバーと招待の管理、現在時間を記録している人の確認
アカウント	プロフィールと設定の表示・更新

ガイドには、すべてのツールが掲載されています。

インタラクティブカード

ChatGPT や Claude など、MCP Apps に対応するクライアントでは、タイマー、新規および変更された時間エントリー、統計、エクスポート、休暇申請がインタラクティブカードとして表示されます。カードはクライアントのライトまたはダークテーマと言語に従います。その他のクライアントでは、同じ情報がテキストで表示されます。

開発

npm install
npm run build       # server and widgets
npm test            # unit tests
npm run test:e2e    # both protocol versions over stdio and HTTP, against the build
npm run dev         # HTTP server on http://127.0.0.1:3000

HTTP サーバーは、認証情報を含まないリクエストに TIMESHEET_API_TOKEN を使用するため、お使いのコンピューターの外部からサーバーにアクセスできる場合は、この環境変数を設定しないでください。その他の設定については、.env.example をご覧ください。

トラブルシューティング

• 何も応答しない、または認証エラーが表示される場合： TIMESHEET_API_TOKEN が余分な空白や引用符なしで設定されていること、また Integrations > API Keys にそのキーがまだ存在することを確認してください。
• コマンドが見つからない場合： node --version を実行して、Node.js 20 以降がインストールされていることを確認してください。
• ツールが上位プランが必要だと報告する場合： MCP サーバーは Pro プラン以上で動作します。

ライセンス

MIT です。詳細は LICENSE.md をご覧ください。

サポート

問題やアイデアは github.com/timesheetIO/timesheet-mcp/issues までお寄せください。