v1.1.0 - Timer Management & Error Handling

New Features

Timer Management

• start_timer: Create a running timer without specifying hours (automatically starts tracking time)
• stop_timer: Stop a running timer using Harvest's dedicated /stop endpoint
• restart_timer: Restart a previously stopped timer using the /restart endpoint
• get_running_timer: Check if a timer is running and display elapsed time

Error Handling

• Added comprehensive error handling to all tool handlers with try-catch blocks
• Improved error messages to include Harvest API response details for better debugging

Improvements

• Fixed stop_timer to use the correct Harvest API v2 endpoint (PATCH /time_entries/{id}/stop)
• Enhanced stop_timer output to show project name, task name, total hours, and date
• All tools now provide detailed error messages when operations fail

Documentation

• Updated CLAUDE.md with new timer tools
• Added detailed README.md sections for all timer operations
• Updated API reference to reflect correct Harvest API v2 endpoints
• Added example interactions for timer workflows

Breaking Changes

None - all existing functionality remains backward compatible.

Installation

npm install
npm run build

Configure in your MCP client (e.g., Claude Desktop):

{
  "mcpServers": {
    "harvest": {
      "command": "node",
      "args": ["/path/to/harvest-mcp/build/index.js"],
      "env": {
        "HARVEST_ACCESS_TOKEN": "your-token-here",
        "HARVEST_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}