Teamwork MCP

Instructions

Implementation Reference

• src/tools/tasks/deleteTask.ts:33-55 (handler)

  The handleDeleteTask function that executes the tool logic: validates input, calls the service, logs, handles errors, and returns MCP response.

  export async function handleDeleteTask(input: any) {
    logger.info('Calling teamworkService.deleteTask()');
    logger.info(`Task ID: ${input?.taskId}`);
    
    try {
      const taskId = String(input?.taskId);
      if (!taskId) {
        throw new Error("Task ID is required");
      }
      
      const result = await teamworkService.deleteTask(taskId);
      logger.info(`Task deleted successfully for task ID: ${taskId}`);
      
      return {
        content: [{
          type: "text",
          text: JSON.stringify({ success: result }, null, 2)
        }]
      };
    } catch (error: any) {
      return createErrorResponse(error, 'Deleting task');
    }
  } 

• src/tools/tasks/deleteTask.ts:11-30 (schema)

  Tool definition including name, description, input schema (taskId: integer, required), and annotations (destructive).

  export const deleteTaskDefinition = {
    name: "deleteTask",
    description: "Delete a task from Teamwork",
    inputSchema: {
      type: "object",
      properties: {
        taskId: {
          type: "integer",
          description: "The ID of the task to delete"
        }
      },
      required: ["taskId"]
    },
    annotations: {
      title: "Delete a Task",
      readOnlyHint: false,
      destructiveHint: true,
      openWorldHint: false
    }
  };

• src/tools/index.ts:77-77 (registration)

  Registration of the deleteTask tool in the toolPairs array, linking definition and handler.

  { definition: deleteTask, handler: handleDeleteTask },

• src/services/tasks/deleteTask.ts:9-18 (helper)

  Supporting service function that performs the actual API deletion of the task via Teamwork API.

  export const deleteTask = async (taskId: string) => {
    try {
      const api = ensureApiClient();
      await api.delete(`/tasks/${taskId}.json`);
      return true;
    } catch (error: any) {
      logger.error(`Error deleting task ${taskId}: ${error.message}`);
      throw new Error(`Failed to delete task ${taskId}`);
    }
  };