Harvest MCP by usefulapi について
Harvest MCP by usefulapiは、Harvestで時間やプロジェクト、請求を管理する人向けのホスト型MCPサーバーです。アカウント情報の参照に加え、時間記録の作成、更新、停止、再開、削除ができます。
主な機能
- 01時間記録とアカウント情報の参照
- 02プロジェクト、クライアント、タスク、ユーザーの一覧
- 03請求書、見積書、経費の参照
- 04時間記録の作成、更新、停止、再開、削除
活用シーン
- 01記録した時間やプロジェクト割り当ての確認
- 02Harvestの時間記録の登録や修正
- 03クライアント、請求書、経費情報の検索
MCP 対応
Harvestのデータ参照と時間記録操作をツールとしてMCPクライアントに公開します。リモートエンドポイントでホストされ、Harvestの認証情報によるOAuthログインを利用します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://harvest.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-harvest https://harvest.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-harvest":{"type":"http","url":"https://harvest.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-harvest":{"type":"http","url":"https://harvest.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-harvest":{"type":"http","url":"https://harvest.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-harvest":{"serverUrl":"https://harvest.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
20| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| to | string | いいえ | この日付以前(当日を含む)の記録のみ。yyyy-mm-dd。 |
| from | string | いいえ | この日付以降(当日を含む)の記録のみ。yyyy-mm-dd。 |
| page | integer | いいえ | ページネーション用のページ番号(1 始まり)。 |
| task_id | integer | いいえ | 単一のタスク ID に絞り込みます。 |
| user_id | integer | いいえ | 単一のユーザー ID に絞り込みます。 |
| per_page | integer | いいえ | 1 ページあたりの結果数(1–2000、Harvest のデフォルトは 2000)。 |
| client_id | integer | いいえ | 単一のクライアント ID に絞り込みます。 |
| is_billed | boolean | いいえ | 請求済み(true)または未請求(false)の記録のみ。 |
| is_running | boolean | いいえ | 実行中(true)または停止済み(false)の記録のみ。 |
| project_id | integer | いいえ | 単一のプロジェクト ID に絞り込みます。 |
| updated_since | string | いいえ | この ISO-8601 日時以降に更新された記録のみ。 |
詳細
usefulapi による Harvest MCP
Harvest アカウントを Claude、Cursor、または任意の MCP クライアントから利用できます。時間記録、プロジェクト、クライアント、タスク、請求書を読み取り、記録済みの時間を記録または更新できます。ホスト型のため、 ローカルへのインストールは不要です。ご自身の認証情報で接続できます。
ライブエンドポイント: https://harvest.usefulapi.io/mcp · ホームページ: https://usefulapi.io
接続
- Claude(claude.ai、Desktop):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://harvest.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http harvest https://harvest.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"harvest": {
"url": "https://harvest.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でログイン処理を行い、ログインページで Harvest の認証情報を入力します。
手順ごとのセットアップ、認証情報の確認方法、よくある質問:https://usefulapi.io/harvest/
初回接続時に、Harvest の個人用アクセストークンとアカウント ID(id.getharvest.com → Developers)を入力します。これらは検証され、ユーザーごとに保存され、ご本人だけに適用されます。設定ファイルにキーを記載する必要はありません。
ツール
| ツール | 種類 | 機能 |
|---|---|---|
harvest_list_time_entries | read | 時間記録の一覧を取得 |
harvest_get_time_entry | read | 時間記録を取得 |
harvest_list_projects | read | プロジェクトの一覧を取得 |
harvest_get_project | read | プロジェクトを取得 |
harvest_list_clients | read | クライアントの一覧を取得 |
harvest_get_client | read | クライアントを取得 |
harvest_list_tasks | read | タスクの一覧を取得 |
harvest_list_users | read | ユーザーの一覧を取得 |
harvest_get_current_user | read | 現在のユーザーを取得 |
harvest_list_project_assignments | read | 自分のプロジェクト割り当ての一覧を取得 |
harvest_list_invoices | read | 請求書の一覧を取得 |
harvest_get_invoice | read | 請求書を取得 |
harvest_list_estimates | read | 見積もりの一覧を取得 |
harvest_list_expenses | read | 経費の一覧を取得 |
harvest_get_company | read | 会社情報を取得 |
harvest_create_time_entry | write | 時間記録を作成 |
harvest_update_time_entry | write | 時間記録を更新 |
harvest_stop_time_entry | write | 実行中の時間記録を停止 |
harvest_restart_time_entry | write | 停止中の時間記録を再開 |
harvest_delete_time_entry | write | 時間記録を削除 |
harvest_usage_status | meta | 利用状況(無料プランの利用量) |
harvest_request_feature | meta | 不足している機能をリクエスト |
harvest_upgrade | meta | Pro にアップグレード(無制限*) |
harvest_cancel_subscription | meta | Pro サブスクリプションを解約 |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアントは実行前に確認する必要があります。meta ツールは利用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 価格 | 上限 |
|---|---|---|
| Free | $0 | 月50回のツール呼び出し |
| Pro | $9/mo または $90/yr(2か月無料) | 無制限* |
*Pro には、このサーバーで月10,000回のツール呼び出しという公正利用上限があります。それ以上必要な場合は、[email protected] までご連絡ください。
Pro の対象はこのサーバーのみです。harvest_upgrade で登録してください(Stripe Checkout のリンクが返されます)。harvest_cancel_subscription でいつでも解約できます。Pro は有料期間の終了まで利用でき、現行期間分の返金はありません。その前に harvest_upgrade を実行すると、解約が取り消されます。または [email protected] までご連絡ください。
ライセンス
MIT — LICENSE を参照してください。ドキュメントのみで、サーバーはホストされています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。