taiste/harvest-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

37 stars 28 forks 品質 71 トレンド 16MIT

Repository Install

taiste/harvest-mcp-server は [https://github.com/taiste/harvest-mcp-server.] からインポートされた MCP サーバーの候補です

概要

taiste/harvest-mcp-server は [https://github.com/taiste/harvest-mcp-server.] からインポートされた MCP サーバーの候補です

概要（AI 翻訳）

このMCP(Model Context Protocol)サーバーは、収穫時間追跡とプロジェクト管理APIと連携します。 Claude や MCP 互換の AI アシスタントは、Recover のアカウントとやり取りし、時間エントリ、プロジェクト、クライアントなどを管理できます。

##特徴

サーバは、次の機能を提供します。

ユーザー

ユーザーの一覧
ユーザー情報の取得

タイムエントリ

フィルタリングオプションでタイムエントリーをリスト
新しいタイムエントリを作成する
始動/停止タイマー
クエリ時間エントリの詳細
退会したタイムシート(承認のためにまだ提出されていないタイムエントリー)を取得する

##プロジェクト

フィルタリングオプション(クライアント、is active、updated since、ページ、per page)でプロジェクトをリスト
詳細なプロジェクト情報の取得
新しいプロジェクトを作成する
既存のプロジェクトを更新(アーカイブに使用されます:[is_active=Falseを渡す)
プロジェクトの削除(決定的 — また、請求書が保持されているにもかかわらず、プロジェクトの時間エントリと費用を削除し、アーカイブは代わりに推奨されます)

タスク割り当て

リストタスクの割り当て(アカウント全体またはプロジェクトにスコープ付け)
詳細なタスク割り当て情報を取得する
新しいタスクの割り当てを作成する(プロジェクトにタスクをリンク)

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Harvest MCP Server

This MCP (Model Context Protocol) server provides integration with the Harvest time tracking and project management API. It allows Claude and other MCP-compatible AI assistants to interact with your Harvest account, helping you manage time entries, projects, clients, and more.

Features

The server provides the following functionality:

Users

List users
Get user details

Time Entries

List time entries with filtering options
Create new time entries
Start/stop timers
Query time entry details
Get unsubmitted timesheets (time entries not yet submitted for approval)

Projects

List projects with filtering options (by client, is_active, updated_since, page, per_page)
Retrieve detailed project information
Create new projects
Update existing projects (also used to archive: pass is_active=False)
Delete projects (destructive — also deletes the project’s time entries and expenses, though invoices are retained; archiving is recommended instead)

Task Assignments

List task assignments (account-wide or scoped to a project)
Retrieve detailed task assignment information
Create new task assignments (link a task to a project)
Update existing task assignments
Delete task assignments (only when no time entries are logged against them)

User Assignments

List user assignments (account-wide or scoped to a project)
Retrieve detailed user assignment information
Create new user assignments (link a user to a project)
Update existing user assignments
Delete user assignments (only when no time entries or expenses are logged against them)

Clients

List clients with filtering options
Retrieve detailed client information

Tasks

List available tasks with filtering options

Estimates

List estimates with filtering options (by client, state, date range, updated_since)
Retrieve detailed estimate information
Look up an estimate by its user-facing number (e.g. “79”)
List messages associated with an estimate
Create new estimates with line items
Update existing estimates (add/update/delete line items via _destroy)
Change estimate state (send, accept, decline, re-open) without sending email
Send estimate messages (emails the estimate to recipients)
Delete estimates

Setup Instructions

Prerequisites

Python 3.10 or higher
Harvest account with API access
Harvest API key and Account ID

Integrating with Claude Desktop

Create or edit your Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows (MSIX installs — the default from claude.ai/download): %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
        "mcpServers": {
            "harvest": {
                "command": "uv",
                "args": [
                  "run",
                  "--directory",
                  "change_directory",
                  "harvest-mcp-server.py"
                ],
                "env": {
                    "HARVEST_ACCOUNT_ID": "account_id",
                    "HARVEST_API_KEY": "api_key"
                }
            }
        }
    }