Harvest MCP Server

Harvest MCP サーバー

Harvest の時間追跡 API と連携します。

https://www.loom.com/share/b611c5d90a454fb2a7eab99ec0dc3d20?sid=edad9a28-1bbb-452c-838d-721bc435908f

機能

この MCP サーバーは、Harvest と連携するために以下のツールを提供します。

ユーザー情報

• get_current_user：認証済みユーザーの情報を取得します

時間エントリー

• list_time_entries：日付による任意の絞り込みを適用して、時間エントリーを一覧表示します
• get_time_entry：ID を指定して、特定の時間エントリーを取得します
• create_time_entry：期間を指定して、新しい時間エントリーを作成します
• create_time_entry_via_start_end：開始時刻と終了時刻を指定して、時間エントリーを作成します
• update_time_entry：既存の時間エントリーを更新します
• delete_time_entry：時間エントリーを削除します
• delete_time_entry_external_reference：時間エントリーの外部参照を削除します
• restart_time_entry：停止した時間エントリーを再開します
• stop_time_entry：実行中の時間エントリーを停止します

プロジェクトとタスク

• list_projects：任意の絞り込みを適用して、すべてのプロジェクトを一覧表示します
• list_tasks：任意の絞り込みを適用して、すべてのタスクを一覧表示します

セットアップ手順

前提条件

• Docker
• API 認証情報を持つ Harvest アカウント

インストール

Claude Desktop ユーザーの場合

Claude Desktop を使用している場合は、以下の設定を MCP 設定ファイルに追加するだけです。

"harvest": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "HARVEST_ACCOUNT_ID",
    "-e",
    "HARVEST_TOKEN",
    "tommcl/harvest-mcp"
  ],
  "env": {
    "HARVEST_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
    "HARVEST_TOKEN": "YOUR_API_TOKEN"
  }
}

注：Docker Desktop がインストールされ、実行中である必要があります。

認証情報：Harvest Developer Tools ページから、Personal Access Token（PAT）と Account ID を取得できます。

オプション 1：Docker Hub から取得（その他の MCP クライアント向け）

1. Docker Hub から Docker イメージを直接取得します。

   docker pull tommcl/harvest-mcp
   

オプション 2：ローカルでビルド（開発向け）

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/harvest-mcp.git
   cd harvest-mcp
   

2. Docker イメージをビルドします。

   docker build -t mcp/harvest .
   

   MCP 設定では、"tommcl/harvest-mcp" の代わりに "mcp/harvest" を使用してください。

   注：サンプルの認証情報を、実際の Harvest API 認証情報に置き換えてください。Personal Access Token（PAT）と Account ID は、Harvest Developer Tools ページから取得できます。

使用方法

Claude Desktop を使って試してみてください。