What is Harvest Mcp

harvest-mcp is an MCP server designed for interacting with the Harvest time tracking API, enabling users to manage time entries, projects, and tasks efficiently.

Use cases

Use cases include tracking billable hours for clients, managing project timelines, and analyzing team productivity through detailed time entry reports.

How to use

To use harvest-mcp, ensure you have Docker installed and a Harvest account with API credentials. Configure your MCP config file with the necessary parameters and run the server using Docker.

Key features

Key features include retrieving user information, listing and managing time entries, projects, and tasks, as well as creating, updating, and deleting time entries.

Where to use

harvest-mcp can be used in project management, time tracking, and productivity applications, particularly in environments where accurate time logging is essential.

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:

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.