start_timer
Initiate a timer for specific projects and tasks using Harvest MCP Server, allowing precise time tracking and optional notes for detailed entries.
Instructions
Start a new timer.
Args:
project_id: The ID of the project to associate with the time entry
task_id: The ID of the task to associate with the time entry
notes: Optional notes about the time entry
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | ||
| project_id | Yes | ||
| task_id | Yes |
Implementation Reference
- harvest-mcp-server.py:154-172 (handler)The handler function for the 'start_timer' tool. Decorated with @mcp.tool() for registration. It starts a new timer by creating a time entry via the Harvest API with the given project_id, task_id, and optional notes. Returns the JSON response.@mcp.tool() async def start_timer(project_id: int, task_id: int, notes: str = None): """Start a new timer. Args: project_id: The ID of the project to associate with the time entry task_id: The ID of the task to associate with the time entry notes: Optional notes about the time entry """ params = { "project_id": project_id, "task_id": task_id, } if notes: params["notes"] = notes response = await harvest_request("time_entries", params, method="POST") return json.dumps(response, indent=2)