harvest-mcp

Harvest MCP Server

For interacting with the Harvest time tracking API.

https://www.loom.com/share/b611c5d90a454fb2a7eab99ec0dc3d20?sid=edad9a28-1bbb-452c-838d-721bc435908f

Features

This MCP server provides the following tools for interacting with Harvest:

User Information

• get_current_user: Retrieve information about the authenticated user

Time Entries

• list_time_entries: List time entries with optional date filtering
• get_time_entry: Retrieve a specific time entry by ID
• create_time_entry: Create a new time entry via duration
• create_time_entry_via_start_end: Create a time entry with start/end times
• update_time_entry: Update an existing time entry
• delete_time_entry: Delete a time entry
• delete_time_entry_external_reference: Delete a time entry's external reference
• restart_time_entry: Restart a stopped time entry
• stop_time_entry: Stop a running time entry

Projects and Tasks

• list_projects: List all projects with optional filtering
• list_tasks: List all tasks with optional filtering

Setup Instructions

Prerequisites

• Docker
• Harvest account with API credentials

Installation

For Claude Desktop Users

If you're using Claude Desktop, you only need to add the following configuration to your MCP config file:

"harvest": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "HARVEST_ACCOUNT_ID",
    "-e",
    "HARVEST_TOKEN",
    "tommcl/harvest-mcp"
  ],
  "env": {
    "HARVEST_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
    "HARVEST_TOKEN": "YOUR_API_TOKEN"
  }
}

Note: You need to have Docker Desktop installed and running.

Credentials: You can obtain your Personal Access Token (PAT) and Account ID from the Harvest Developer Tools page.

Option 1: Pull from Docker Hub (For Other MCP Clients)

1. Pull the Docker image directly from Docker Hub:

   docker pull tommcl/harvest-mcp
   

Option 2: Build Locally (For Development)

1. Clone the repository:

   git clone https://github.com/yourusername/harvest-mcp.git
   cd harvest-mcp
   

2. Build the Docker image:

   docker build -t mcp/harvest .
   

   Then use "mcp/harvest" instead of "tommcl/harvest-mcp" in your MCP config.

   Note: Replace the example credentials with your actual Harvest API credentials. You can obtain your Personal Access Token (PAT) and Account ID from the Harvest Developer Tools page.

Usage

Test it out using Claude Desktop.