Skip to main content
Glama
mayank2424

Harvest Time Tracking MCP Server

by mayank2424
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Harvest Time Tracking MCP Server

npm version

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

Related MCP server: Harvest MCP Server

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• 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• clientId: string (optional) - Client ID• 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)• to: string (optional) - End date (YYYY-MM-DD)• userId: string (optional) - User ID• projectId: string (optional) - Project ID• 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• taskId: string - Task ID• userId: string - User ID• hours: number - Hours spent• 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:

# Find your npx and node paths
which npx
# e.g. /Users/you/.nvm/versions/node/v22.20.0/bin/npx

Then update your MCP config:

{
  "mcpServers": {
    "Harvest": {
      "command": "/Users/you/.nvm/versions/node/v22.20.0/bin/npx",
      "args": [
        "-y",
        "@mayankg0324/mcp-server-harvest"
      ],
      "env": {
        "PATH": "/Users/you/.nvm/versions/node/v22.20.0/bin:/usr/bin:/bin",
        "HARVEST_ACCOUNT_ID": "<Harvest Account ID>",
        "HARVEST_ACCESS_TOKEN": "<Harvest Personal Access Token>",
        "HARVEST_BASE_URL": "<Harvest Base URL>"
      }
    }
  }
}

Local Development

  1. Install dependencies:

    npm install

  2. Build the project:

    npm run build

    This will create a dist directory containing the compiled JavaScript files.

  3. To use the local development version, modify your MCP server config to point to the local build:

    {
  "mcpServers": {
    "Harvest": {
      "command": "node",
      "args": [
        "path/to/local/build/dist/index.js"
      ],
      "env": {
        "HARVEST_ACCOUNT_ID": "<Harvest Account ID>",
        "HARVEST_ACCESS_TOKEN": "<Harvest Personal Access Token>",
        "HARVEST_BASE_URL": "<Harvest Base URL>"
      }
    }
  }
}

  4. Restart the client application (Claude, Cursor) to apply the changes.

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Harvest MCP Server

    taiste
    A
    license
    A
    quality
    D
    maintenance
    Integrates with Harvest time tracking API, enabling AI assistants to manage time entries, projects, clients, and tasks through natural language commands.
    11
    38
    MIT

  • Harvest MCP Server

    jpeggdev
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    Provides MCP integration for Harvest's time tracking, project management, and invoicing functionality, enabling natural language interaction with Harvest API through tools for managing clients, time entries, projects, tasks, and users.
    -