MCP 服务器

Harvest MCP Server

Provides MCP integration for Harvest's time tracking, project management, and invoicing functionality, enabling natural language interaction with Harvest API through tools for managing clients, time entries, projects, tasks, and users.

README

Harvest MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with the Harvest API. This server exposes Harvest's time tracking, project management, and invoicing functionality through a standardized MCP interface.

Features

The Harvest MCP server provides access to:

Company: Retrieve company information
Contacts: List, create, update, and delete contacts
Clients: Manage client records
Time Entries: Track time, list entries, start/stop timers
Projects: Create and manage projects
Tasks: Define and organize tasks
Users: List users and get current user info

Prerequisites

Node.js 18 or higher
A Harvest account with API access
Harvest API credentials (Account ID and Personal Access Token)

Installation

Clone this repository:

git clone <repository-url>
cd harvest-mcp

Install dependencies:

npm install

Build the TypeScript code:

npm run build

Create a .env file based on .env.example:

cp .env.example .env

Add your Harvest credentials to .env:

HARVEST_ACCOUNT_ID=your_harvest_account_id
HARVEST_ACCESS_TOKEN=your_harvest_personal_access_token

Getting Harvest API Credentials

Log in to your Harvest account
Go to Settings → My Profile
Click on Personal Access Tokens
Click Create New Personal Access Token
Give it a name and click Create Personal Access Token
Copy the token (you won't be able to see it again)
Your Account ID is visible in the URL when logged into Harvest

Usage

Running the Server

For development:

npm run dev

For production:

npm start

Configuring with Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "harvest": {
      "command": "node",
      "args": ["path/to/harvest-mcp/dist/index.js"],
      "env": {
        "HARVEST_ACCOUNT_ID": "your_harvest_account_id",
        "HARVEST_ACCESS_TOKEN": "your_harvest_personal_access_token"
      }
    }
  }
}

Available Tools

Company

harvest_get_company - Get company information

Contacts

harvest_list_contacts - List all contacts
harvest_get_contact - Get a specific contact
harvest_create_contact - Create a new contact
harvest_update_contact - Update an existing contact
harvest_delete_contact - Delete a contact

Clients

harvest_list_clients - List all clients
harvest_get_client - Get a specific client
harvest_create_client - Create a new client
harvest_update_client - Update an existing client
harvest_delete_client - Delete a client

Time Entries

harvest_list_time_entries - List time entries with filters
harvest_get_time_entry - Get a specific time entry
harvest_create_time_entry - Create a new time entry
harvest_update_time_entry - Update an existing time entry
harvest_delete_time_entry - Delete a time entry
harvest_restart_time_entry - Restart a stopped timer
harvest_stop_time_entry - Stop a running timer

Projects

harvest_list_projects - List all projects
harvest_get_project - Get a specific project
harvest_create_project - Create a new project
harvest_update_project - Update an existing project
harvest_delete_project - Delete a project

Tasks

harvest_list_tasks - List all tasks
harvest_get_task - Get a specific task
harvest_create_task - Create a new task
harvest_update_task - Update an existing task
harvest_delete_task - Delete a task

Users

harvest_list_users - List all users
harvest_get_user - Get a specific user
harvest_get_current_user - Get the current authenticated user

Example Usage

Once configured, you can use the tools in Claude Desktop:

"Can you show me my current time entries for this week?"
"Create a new time entry for 2 hours on the 'Website Redesign' project"
"List all active projects for client 'Acme Corp'"

Development

Project Structure

harvest-mcp/
├── src/
│   ├── index.ts          # Main server entry point
│   ├── harvest-client.ts # Harvest API client
│   ├── tools.ts          # Tool definitions
│   └── types.ts          # TypeScript type definitions
├── dist/                 # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md