freedcamp_update_task

Instructions

Implementation Reference

• src/mcpServer.ts:167-176 (handler)

  The main tool handler function that processes a list of tasks to update, builds authentication parameters, calls the single task update helper for each, and returns formatted text results.

  async (args) => {
    const tasksToUpdate = args.tasks;
    const authParams = buildFreedcampAuthParams({
      api_key: config.apiKey,
      api_secret: config.apiSecret,
    });
  
    const results = await Promise.all(tasksToUpdate.map((taskArg: any) => processSingleUpdateTask(taskArg, authParams)));
    return { content: results.map(r => ({ type: "text", text: JSON.stringify(r) })) };
  }

• src/mcpServer.ts:21-29 (schema)

  Zod schema defining the input parameters for updating a single task. Referenced in the tool's inputSchema as an array for bulk support.

  const singleUpdateTaskSchema = z.object({
    task_id: z.string().describe("ID of the task to update (required) - must be valid existing Freedcamp task ID"),
    title: z.string().optional().describe("New task title (optional)"),
    description: z.string().optional().describe("New task description (optional)"),
    due_date: z.string().optional().describe("New due date as Unix timestamp string (optional) - e.g., '1735689600' for 2025-01-01"),
    assigned_to_id: z.string().optional().describe("User ID to reassign the task to (optional) - must be valid Freedcamp user ID"),
    priority: z.number().int().min(0).max(3).optional().describe("New task priority level (optional): 0=Low, 1=Normal, 2=High, 3=Urgent"),
    status: z.number().int().min(0).max(2).optional().describe("New task status (optional): 0=Open, 1=Completed, 2=Closed")
  });

• src/mcpServer.ts:157-177 (registration)

  Registration of the freedcamp_update_task tool in the MCP server, including description, input schema (bulk array), annotations, and handler function.

  server.registerTool("freedcamp_update_task",
    {
      description: "Update one or more existing tasks in Freedcamp including title, description, priority, due date, assignee, and status. Supports bulk operations for updating multiple tasks at once.",
      inputSchema: {
        tasks: z.array(singleUpdateTaskSchema)
      },
      annotations: {
        title: "Update Task"
      }
    },
    async (args) => {
      const tasksToUpdate = args.tasks;
      const authParams = buildFreedcampAuthParams({
        api_key: config.apiKey,
        api_secret: config.apiSecret,
      });
  
      const results = await Promise.all(tasksToUpdate.map((taskArg: any) => processSingleUpdateTask(taskArg, authParams)));
      return { content: results.map(r => ({ type: "text", text: JSON.stringify(r) })) };
    }
  );

• src/mcpServer.ts:91-112 (helper)

  Helper function that handles updating a single task: prepares data payload from args, makes POST request to Freedcamp edit endpoint, handles success/error responses.

  async function processSingleUpdateTask(taskArgs: z.infer<typeof singleUpdateTaskSchema>, authParams: Record<string, string>) {
    try {
      const data: Record<string, any> = {};
      if (taskArgs.title) data.title = taskArgs.title;
      if (taskArgs.description) data.description = taskArgs.description;
      if (taskArgs.due_date) data.due_date = taskArgs.due_date;
      if (taskArgs.assigned_to_id) data.assigned_to_id = taskArgs.assigned_to_id;
      if (typeof taskArgs.priority === "number") data.priority = taskArgs.priority;
      if (typeof taskArgs.status === "number") data.status = taskArgs.status;
  
      const url = `https://freedcamp.com/api/v1/tasks/${taskArgs.task_id}/edit`;
      const result = await executeFreedcampRequest(url, "POST", authParams, data);
  
      if (result.error) {
        return { type: "text", text: `Error updating task ID "${taskArgs.task_id}": ${result.error}`, task_id: taskArgs.task_id, details: result.details };
      }
      return { type: "text", text: `Task ID "${taskArgs.task_id}" updated.`, task_id: taskArgs.task_id, data: result.data };
    } catch (err: any) {
      console.error(`Error processing update for task ID "${taskArgs.task_id}":`, err);
      return { type: "text", text: `Failed to update task ID "${taskArgs.task_id}": ${err.message}`, task_id: taskArgs.task_id, error_details: err };
    }
  }

• src/mcpServer.ts:35-65 (helper)

  Utility function to execute HTTP requests to Freedcamp API using FormData for auth and body, handles DELETE specially, parses responses and errors.

  async function executeFreedcampRequest(url: string, method: string, authParams: Record<string, string>, bodyData?: Record<string, any>) {
    const form = new FormData();
    if (bodyData) {
      form.append("data", JSON.stringify(bodyData));
    }
    for (const [k, v] of Object.entries(authParams)) {
      form.append(k, v);
    }
  
    let requestUrl = url;
    let requestBody: any = form;
    if (method === "DELETE" && !bodyData) {
      const params = new URLSearchParams(authParams);
      requestUrl = `${url}?${params.toString()}`;
      requestBody = undefined;
    }
  
    console.log(`Making ${method} request to Freedcamp API: ${requestUrl}`);
  
    const resp = await fetch(requestUrl, {
      method: method,
      body: requestBody,
    });
    const json = (await resp.json()) as any;
    console.log("Freedcamp API response:", json);
  
    if (!resp.ok || (json && json.http_code >= 400)) {
      return { error: json?.msg || resp.statusText, details: json };
    }
    return { success: true, data: json?.data };
  }