Enables loading environment variables from a .env file for configuration, particularly for storing Harvest credentials like account ID and access token.
Supports version control for the codebase, with instructions for cloning the repository as part of the installation process.
Used for package management, dependency installation, and running scripts for building, testing, and developing the Harvest MCP server.
Harvest MCP Server
A Model Context Protocol (MCP) server that provides integration with the Harvest API v2.
Features
This MCP server provides tools for interacting with Harvest time tracking data:
Time Entry Management
List time entries with filters
Create new time entries
Update existing time entries
Delete time entries
Project & Task Management
List and view projects
List available tasks
User & Client Management
Get current user information
List all users
List all clients
Reporting
Generate time reports for date ranges
Assignments
List project assignments
List task assignments for projects
Related MCP server: Time Tools MCP Server
Installation
Configuration
Copy the environment template:
Edit
.envand add your Harvest credentials:
To get your Harvest credentials:
Log in to your Harvest account
Go to Developers
Create a new personal access token
Note your Account ID
Development
Testing
The project includes comprehensive tests to verify integration with the Harvest API:
Integration Tests
The integration tests connect to your actual Harvest account and perform read-only operations to verify the MCP server works correctly. These tests:
Connect to the MCP server via stdio transport
Test all 14 available tools
Verify proper data structure responses
Test error handling for invalid inputs
Use actual Harvest API data (read-only operations only)
Requirements for integration tests:
Valid
.envfile withHARVEST_ACCOUNT_IDandHARVEST_ACCESS_TOKENActive Harvest account with some data (projects, time entries, etc.)
Network access to Harvest API
Using with Claude Desktop
Add the following to your Claude Desktop configuration file:
Available Tools
Tool | Description |
| List time entries with optional filters |
| Create a new time entry |
| Update an existing time entry |
| Delete a time entry |
| Restart a stopped time entry timer |
| Stop a running time entry timer |
| List all projects |
| Get details of a specific project |
| List all tasks |
| Get information about the authenticated user |
| List all users in the account |
| List all clients |
| Get time report for a date range |
| List project assignments for the current user |
| List task assignments for a project |
Tool Parameters
Time Entry Tools
harvest_list_time_entries
user_id(string): Filter by user IDproject_id(string): Filter by project IDfrom(string): Start date (YYYY-MM-DD)to(string): End date (YYYY-MM-DD)page(number): Page numberper_page(number): Results per page (max 100)
harvest_create_time_entry
project_id(string, required): Project IDtask_id(string, required): Task IDspent_date(string, required): Date of the entry (YYYY-MM-DD)hours(number): Hours workednotes(string): Notes for the time entry
License
MIT