Harvest MCP

🚀 Harvest Time Tracking MCP Server

This server is designed to interact with the Harvest Time Tracking API, enabling seamless access to various time - tracking features.

Click here for a video demonstration

✨ Features

This MCP server offers 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: Get a specific time entry by its ID.
• create_time_entry: Create a new time entry with a duration.
• create_time_entry_via_start_end: Create a time entry using start/end times.
• update_time_entry: Update an existing time entry.
• delete_time_entry: Delete a time entry.
• delete_time_entry_external_reference: Delete the external reference of a time entry.
• 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.

📦 Installation

Prerequisites

• Docker
• A Harvest account with API credentials

Installation Steps

For Claude Desktop Users

If you are using Claude Desktop, simply add the following configuration to your MCP configuration 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"
  }
}

⚠️ Important Note

You need to have Docker Desktop installed and running.

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

Option 1: Pull from Docker Hub (for other MCP customers)

1. Pull the Docker image directly from Docker Hub:

   docker pull tommcl/harvest-mcp
   

Option 2: Local Build (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 configuration.

⚠️ Important Note

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

💻 Usage Examples

Basic Usage

You can test the server using Claude Desktop.