harvest_restart_timer

Restart a stopped time entry timer in Harvest to resume tracking work hours for accurate time management.

Instructions

Restart a stopped time entry timer. Use about {"tool": "harvest_restart_timer"} for detailed workflow and examples.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	Time entry ID

Implementation Reference

src/harvest-client.ts:104-108 (handler)
Core handler function that implements the Harvest API call to restart a time entry timer via PATCH /time_entries/{id}/restart.
```
async restartTimer(id: string) {
  return this.makeRequest(`/time_entries/${id}/restart`, {
    method: 'PATCH',
  });
}
```

src/index.ts:129-138 (handler)

MCP server request handler case that dispatches harvest_restart_timer calls to the HarvestClient.restartTimer method.

case 'harvest_restart_timer':
  const restartedTimer = await harvestClient.restartTimer(typedArgs.id as string);
  return {
    content: [
      {
        type: 'text',
        text: JSON.stringify(restartedTimer, null, 2),
      },
    ],
  };

src/tools.ts:62-72 (registration)

Tool registration in the tools array, including name, description, and input schema requiring 'id' parameter.

{
  name: 'harvest_restart_timer',
  description: 'Restart a stopped time entry timer. Use about {"tool": "harvest_restart_timer"} for detailed workflow and examples.',
  inputSchema: {
    type: 'object',
    properties: {
      id: { type: 'string', description: 'Time entry ID' }
    },
    required: ['id']
  }
},

src/tools.ts:65-71 (schema)
Input schema definition specifying the required 'id' parameter of type string for the harvest_restart_timer tool.
```
inputSchema: {
  type: 'object',
  properties: {
    id: { type: 'string', description: 'Time entry ID' }
  },
  required: ['id']
}
```

src/harvest-client.ts:425-466 (helper)

Detailed documentation and usage examples for the harvest_restart_timer tool provided in the getAboutInfo method.

      'harvest_restart_timer': `# harvest_restart_timer

Restarts a stopped time entry timer to resume time tracking.

## Purpose
Resume timing on a previously stopped time entry, setting is_running to true and timer_started_at to current time.

## Parameters
- \`id\` (string, required): The time entry ID to restart

## Example Usage

**Restart a stopped timer:**
\`\`\`json
{
  "tool": "harvest_restart_timer",
  "id": "98765"
}
\`\`\`

## Response Format
Returns the updated time entry with:
- \`is_running\`: true
- \`timer_started_at\`: Current timestamp
- \`hours\`: Previous accumulated hours
- All other time entry properties

## Requirements
- Time entry must exist
- Timer must not already be running
- Only one timer can run at a time per user

## Workflow
1. Find stopped entry: harvest_list_time_entries
2. Restart timer: harvest_restart_timer  
3. Work on the task
4. Stop when done: harvest_stop_timer

## Error Conditions
- Entry not found: Invalid ID
- Timer already running: Cannot restart running timer
- Another timer running: Stop other timer first`,

Harvest MCP Server