Harvest Natural Language Time Entry MCP Server

What is Harvest Natural Language Time Entry MCP Server?

An MCP server that integrates with Harvest to log time entries using natural language, including special handling for leave requests. It is designed for Harvest users who want more intuitive time tracking.

How to use Harvest Natural Language Time Entry MCP Server?

Install the Claude desktop app, clone the repository, run npm install && npm run build, then execute node build/setup.js to enter your Harvest credentials, work day hours, and timezone. After restarting Claude, you can use natural language commands such as "2 hours on Project X doing development work today" or "I'm off sick today". The server provides tools: log_time, get_time_report, list_projects, list_tasks, and list_entries.

Key features of Harvest Natural Language Time Entry MCP Server

• Natural language time entry parsing
• Special leave request handling (e.g., “I’m off sick today”)
• Configurable work day hours
• Timezone support
• Automatic project and task matching
• Smart date parsing (today, yesterday, etc.)

Use cases of Harvest Natural Language Time Entry MCP Server

• Quickly log time entries with natural language phrases
• Log leave requests (sick, annual) using standard work day hours
• Generate time reports by project, client, task, or team member
• List available projects, tasks, and recent time entries
• Query time summaries for periods like last week, month, or Q1

FAQ from Harvest Natural Language Time Entry MCP Server

What are the prerequisites?

You need Node.js installed, a Harvest account, a personal access token from Harvest Developer Tools, and your Account ID.

How do I install the server?

Clone the repository, run npm install && npm run build, then run node build/setup.js and follow the prompts to enter your token, account ID, work day hours, and timezone. Restart the Claude desktop app.

What tools are available?

The server provides log_time, get_time_report, list_projects, list_tasks, and list_entries. Each accepts natural language input.

How does leave request handling work?

When you say something like “I’m off sick today” or “Taking annual leave next week”, the server automatically logs the standard work day hours (default 7.5) for the appropriate days.

How do I update the server?

Run git pull, then npm install && npm run build. The setup script configures Claude to use the local build, so updates are available after rebuilding.