mcpField
H
Harvest MCP by usefulapi

Harvest MCP by usefulapi

リモート
usefulapi.io生産性0今日更新
リポジトリ公式サイト

Harvest MCP by usefulapi について

Harvest MCP by usefulapiは、Harvestで時間やプロジェクト、請求を管理する人向けのホスト型MCPサーバーです。アカウント情報の参照に加え、時間記録の作成、更新、停止、再開、削除ができます。

主な機能

  1. 01時間記録とアカウント情報の参照
  2. 02プロジェクト、クライアント、タスク、ユーザーの一覧
  3. 03請求書、見積書、経費の参照
  4. 04時間記録の作成、更新、停止、再開、削除

活用シーン

  1. 01記録した時間やプロジェクト割り当ての確認
  2. 02Harvestの時間記録の登録や修正
  3. 03クライアント、請求書、経費情報の検索

MCP 対応

Harvestのデータ参照と時間記録操作をツールとしてMCPクライアントに公開します。リモートエンドポイントでホストされ、Harvestの認証情報によるOAuthログインを利用します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://harvest.usefulapi.io/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

20
パラメーター型必須説明
tostringいいえこの日付以前(当日を含む)の記録のみ。yyyy-mm-dd。
fromstringいいえこの日付以降(当日を含む)の記録のみ。yyyy-mm-dd。
pageintegerいいえページネーション用のページ番号(1 始まり)。
task_idintegerいいえ単一のタスク ID に絞り込みます。
user_idintegerいいえ単一のユーザー ID に絞り込みます。
per_pageintegerいいえ1 ページあたりの結果数(1–2000、Harvest のデフォルトは 2000)。
client_idintegerいいえ単一のクライアント ID に絞り込みます。
is_billedbooleanいいえ請求済み(true)または未請求(false)の記録のみ。
is_runningbooleanいいえ実行中(true)または停止済み(false)の記録のみ。
project_idintegerいいえ単一のプロジェクト ID に絞り込みます。
updated_sincestringいいえこの 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_entriesread時間記録の一覧を取得
harvest_get_time_entryread時間記録を取得
harvest_list_projectsreadプロジェクトの一覧を取得
harvest_get_projectreadプロジェクトを取得
harvest_list_clientsreadクライアントの一覧を取得
harvest_get_clientreadクライアントを取得
harvest_list_tasksreadタスクの一覧を取得
harvest_list_usersreadユーザーの一覧を取得
harvest_get_current_userread現在のユーザーを取得
harvest_list_project_assignmentsread自分のプロジェクト割り当ての一覧を取得
harvest_list_invoicesread請求書の一覧を取得
harvest_get_invoiceread請求書を取得
harvest_list_estimatesread見積もりの一覧を取得
harvest_list_expensesread経費の一覧を取得
harvest_get_companyread会社情報を取得
harvest_create_time_entrywrite時間記録を作成
harvest_update_time_entrywrite時間記録を更新
harvest_stop_time_entrywrite実行中の時間記録を停止
harvest_restart_time_entrywrite停止中の時間記録を再開
harvest_delete_time_entrywrite時間記録を削除
harvest_usage_statusmeta利用状況(無料プランの利用量)
harvest_request_featuremeta不足している機能をリクエスト
harvest_upgrademetaPro にアップグレード(無制限*)
harvest_cancel_subscriptionmetaPro サブスクリプションを解約

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 を参照してください。ドキュメントのみで、サーバーはホストされています。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。