taiste/harvest-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

38 stars 28 forks 품질 71 트렌드 16MIT

Repository Install

taiste/harvest-mcp-server는 MCP 서버 후보가 https://github.com/taiste/harvest-mcp-server.에서 수입되었습니다

개요

taiste/harvest-mcp-server는 MCP 서버 후보가 https://github.com/taiste/harvest-mcp-server.에서 수입되었습니다

개요(AI 번역)

이 MCP (Model Context Protocol) 서버는 Harvest 시간 추적 및 프로젝트 관리 API와 통합을 제공합니다. Claude 및 기타 MCP 호환 AI 조수는 Harvest 계정과 상호 작용하며, 시간 항목, 프로젝트, 클라이언트 등을 관리할 수 있습니다.

특징

서버는 다음과 같은 기능을 제공합니다:

사용자

사용자 목록
사용자 상세보기

시간 항목

필터링 옵션이있는 시간 항목 목록
새로운 시간 항목 만들기
시작 / 정지 타이머
Query 시간 입력 세부 정보
unsubmitted timesheets (시간 항목은 아직 승인되지 않음)

프로젝트

필터링 옵션이있는 목록 프로젝트 ( client, is active, updated since, 페이지, per page)
상세한 프로젝트 정보를 검색
새 프로젝트 만들기
기존 프로젝트 업데이트 (또한 아카이브에 사용 : 패스 is_active=False)
프로젝트 삭제 (destructive - 또한 청구서가 유지되지만 프로젝트의 시간 항목 및 비용을 삭제합니다. 보관은 대신 권장됩니다)

작업 할당

작업 할당 목록 (프로젝트에 따라 전체 또는 범위)
상세한 작업 할당 정보를 검색
새 작업 할당 만들기 (프로젝트에 작업 연결)

이 페이지는 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"
                }
            }
        }
    }