harvest-mcp-server

Instructions

Implementation Reference

• src/tools/projects.ts:137-153 (handler)

  The handler for creating a project task assignment, using the Harvest API client.

  class CreateProjectTaskAssignmentHandler implements ToolHandler {
    constructor(private readonly config: BaseToolConfig) {}
  
    async execute(args: Record<string, any>): Promise<CallToolResult> {
      try {
        const validatedArgs = validateInput(CreateProjectTaskAssignmentSchema, args, 'create project task assignment');
        logger.info('Creating project task assignment via Harvest API', { projectId: validatedArgs.project_id, taskId: validatedArgs.task_id });
        const assignment = await this.config.harvestClient.createProjectTaskAssignment(validatedArgs.project_id, validatedArgs);
        
        return {
          content: [{ type: 'text', text: JSON.stringify(assignment, null, 2) }],
        };
      } catch (error) {
        return handleMCPToolError(error, 'create_project_task_assignment');
      }
    }
  }

• src/schemas/task.ts:80-88 (schema)

  Input validation schema for the create_project_task_assignment tool.

  export const CreateProjectTaskAssignmentSchema = z.object({
    project_id: z.number().int().positive(),
    task_id: z.number().int().positive(),
    is_active: z.boolean().optional().default(true),
    billable: z.boolean().optional().default(true),
    hourly_rate: z.number().min(0).optional(),
    budget: z.number().min(0).optional(),
  });

• src/tools/projects.ts:341-360 (registration)

  Tool registration for create_project_task_assignment.

  {
    tool: {
      name: 'create_project_task_assignment',
      description: 'Assign a task to a project, making it available for time tracking on that project. Allows setting project-specific rates and budgets.',
      inputSchema: {
        type: 'object',
        properties: {
          project_id: { type: 'number', description: 'The project ID to assign the task to (required)' },
          task_id: { type: 'number', description: 'The task ID to assign (required)' },
          is_active: { type: 'boolean', description: 'Whether this assignment is active' },
          billable: { type: 'boolean', description: 'Whether time tracked on this task is billable' },
          hourly_rate: { type: 'number', minimum: 0, description: 'Hourly rate for this task on this project' },
          budget: { type: 'number', minimum: 0, description: 'Budget allocation for this task' },
        },
        required: ['project_id', 'task_id'],
        additionalProperties: false,
      },
    },
    handler: new CreateProjectTaskAssignmentHandler(config),
  },