harvest-mcp-server
1
The Harvest Natural Language Time Entry MCP Server allows users to log Harvest time entries using natural language, thus providing intuitive time tracking and handling leave requests. It supports features like automatic project matching and timezone configuration.
Harvest Natural Language Time Entry MCP Server
An MCP server that enables logging of Harvest time entries utilizing natural language, with special features for handling leave requests. It simplifies time tracking through intuitive natural language inputs.
Features
- Natural language time entry parsing
- Special leave request handling
- Configurable work day hours
- Timezone support
- Automatic project and task matching
- Smart date parsing (today, yesterday, etc.)
Prerequisites
- Node.js installed
- A Harvest account
- Personal access token from Harvest Developer Tools
- Account ID
Installation
- Install the Claude desktop app
- Clone the repository
- Install dependencies and build
- Run the setup script
- Configure with prompts
- Restart Claude desktop app
Usage
log_time
Log time entries using natural language
- Examples include booking hours or days off.
get_time_report
Generate time reports via natural language queries
- Time Period Options and Report Types available.
list_projects
List available Harvest projects.
list_tasks
List tasks for a specific project.
list_entries
View recent time entries.
Configuration
Environment variables supported for configuration.
Development
- Built using TypeScript, MCP SDK, and chrono-node.
- Contributions via forks and pull requests.
License
MIT License