.png)
Harvest Time Tracking MCP Server
About
MCP (Model Context Protocol) server for Harvest Time Tracking.
Details
- Author
- mayank2424
- GitHub stars
- 1
- Downloads
- 238
- Categories
- Productivity
Jump to
- Retrieve company information (name, URL, ID, currency)
- Search and get details for clients, projects, and users
- List project user assignments and task assignments
- Search and fetch time entry details with filters
- Create new time entries with project, task, user, and hours
- Works with Claude Desktop and Cursor IDE out of the box
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Harvest Time Tracking MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via npx -y @mayankg0324/mcp-server-harvest. Configure the environment variables HARVEST_ACCOUNT_ID, HARVEST_ACCESS_TOKEN, and HARVEST_BASE_URL in your MCP client’s config file (e.g., Claude Desktop claude-desktop-config.json or Cursor IDE mcp.json). Then use the available tools (e.g., search-clients, create-time-entry) through your LLM client.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"harvest time tracking mcp server": {
"Harvest": {
"command": "npx",
"args": [
"@harvest/mcp-server-typescript"
],
"env": {
"HARVEST_ACCOUNT_ID": "<Harvest Account ID>",
"HARVEST_ACCESS_TOKEN": "<Harvest Personal Access Token>",
"HARVEST_BASE_URL": "<Harvest Base URL>"
}
}
}
}
}McpServers
{
"Harvest": {
"command": "npx",
"args": [
"@harvest/mcp-server-typescript"
],
"env": {
"HARVEST_ACCOUNT_ID": "<Harvest Account ID>",
"HARVEST_ACCESS_TOKEN": "<Harvest Personal Access Token>",
"HARVEST_BASE_URL": "<Harvest Base URL>"
}
}
}Harvest Time Tracking MCP Server
A TypeScript based MCP (Model Context Protocol) server for Harvest time tracking app enabling LLM clients to interact with Harvest account.
Installation
npx -y @mayankg0324/mcp-server-harvest
Prerequisites
- Node.js >= 18 (or Bun Runtime for development)
- Harvest account with API access
- API Personal Access Token from Harvest
- Account ID from Harvest
_More details on how to create a Personal Access Token can be found in the Harvest API documentation._
Available Tools
| Tool | Description | Inputs | Output |
|------|-------------|---------|---------|
| get-company | Get company information | None | Company Information (Name, URL, ID and Currency) |
| search-clients | Searches for clients | • name: string (optional) - Client name<br>• isActive: boolean (optional) - Active status | List of clients with IDs and details |
| get-client | Get client information | • clientId: string - Client ID | Detailed client information |
| search-projects | Searches for projects | • name: string (optional) - Project name<br>• clientId: string (optional) - Client ID<br>• isActive: boolean (optional) - Active status | List of projects with IDs and details |
| get-project | Get project information | • projectId: string - Project ID | Detailed project information |
| list-users | Lists all users | None | List of users with IDs and details |
| get-user | Get user information | • userId: string - User ID | Detailed user information |
| list-project-users | List project user assignments | • projectId: string - Project ID | List of users assigned to project |
| list-project-tasks | List project task assignments | • projectId: string - Project ID | List of tasks assigned to project |
| search-time-entries | Searches for time entries | • from: string (optional) - Start date (YYYY-MM-DD)<br>• to: string (optional) - End date (YYYY-MM-DD)<br>• userId: string (optional) - User ID<br>• projectId: string (optional) - Project ID<br>• clientId: string (optional) - Client ID | List of time entries with details |
| get-time-entry | Get time entry details | • timeEntryId: string - Time Entry ID | Detailed time entry information |
| create-time-entry | Create a new time entry | • projectId: string - Project ID<br>• taskId: string - Task ID<br>• userId: string - User ID<br>• hours: number - Hours spent<br>• notes: string (optional) - Additional notes | Created time entry details |
_Note: More tools coming soon._
Usage
Claude Desktop
Open the Claude desktop config file claude-desktop-config.json and add the following under mcpServers:
{
"mcpServers": {
"Harvest": {
"command": "npx",
"args": [
"-y",
"@mayankg0324/mcp-server-harvest"
],
"env": {
"HARVEST_ACCOUNT_ID": "<Harvest Account ID>",
"HARVEST_ACCESS_TOKEN": "<Harvest Personal Access Token>",
"HARVEST_BASE_URL": "<Harvest Base URL>"
}
}
}
}
Cursor IDE
Open the Cursor IDE config file ~/.cursor/mcp.json or <project-root>/.cursor/mcp.json and add the following under mcpServers:
{
"mcpServers": {
"Harvest": {
"command": "npx",
"args": [
"-y",
"@mayankg0324/mcp-server-harvest"
],
"env": {
"HARVEST_ACCOUNT_ID": "<Harvest Account ID>",
"HARVEST_ACCESS_TOKEN": "<Harvest Personal Access Token>",
"HARVEST_BASE_URL": "<Harvest Base URL>"
}
}
}
}
Troubleshooting
spawn npx ENOENT or env: node: No such file or directory
This happens when your MCP client (Claude Desktop, Cursor) cannot find npx or node in its PATH. GUI applications often don't inherit your shell's PATH, especially if you use a version manager like nvm, fnm, or volta.
Fix: Use the full path to npx and include your Node bin directory in the PATH env variable:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
