Harvest MCP Server

Instructions

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

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)