Sunsama MCP Server

Instructions

Implementation Reference

• src/tools/task-tools.ts:159-180 (handler)

  The main handler function that executes the 'delete-task' tool logic by calling the client's deleteTask method and formatting the JSON response.

  export const deleteTaskTool = withTransportClient({
    name: "delete-task",
    description: "Delete a task permanently",
    parameters: deleteTaskSchema,
    execute: async (
      { taskId, limitResponsePayload, wasTaskMerged }: DeleteTaskInput,
      context: ToolContext,
    ) => {
      const result = await context.client.deleteTask(
        taskId,
        limitResponsePayload,
        wasTaskMerged,
      );
  
      return formatJsonResponse({
        success: result.success,
        taskId,
        deleted: true,
        updatedFields: result.updatedFields,
      });
    },
  });

• src/schemas.ts:149-159 (schema)

  Zod input schema for the 'delete-task' tool defining required taskId and optional limitResponsePayload, wasTaskMerged parameters.

  export const deleteTaskSchema = z.object({
    taskId: z.string().min(1, "Task ID is required").describe(
      "The ID of the task to delete",
    ),
    limitResponsePayload: z.boolean().optional().describe(
      "Whether to limit response size",
    ),
    wasTaskMerged: z.boolean().optional().describe(
      "Whether the task was merged before deletion",
    ),
  });

• src/main.ts:32-44 (registration)

  Registration of all tools to the MCP server, including 'delete-task' via the allTools array imported from src/tools/index.ts.

  // Register all tools
  allTools.forEach((tool) => {
    server.registerTool(
      tool.name,
      {
        description: tool.description,
        inputSchema: "shape" in tool.parameters
          ? tool.parameters.shape
          : tool.parameters,
      },
      tool.execute,
    );
  });

• src/tools/task-tools.ts:406-426 (registration)

  The taskTools array that includes the deleteTaskTool, which is spread into allTools for server registration.

  export const taskTools = [
    // Query tools
    getTasksBacklogTool,
    getTasksByDayTool,
    getArchivedTasksTool,
    getTaskByIdTool,
  
    // Lifecycle tools
    createTaskTool,
    deleteTaskTool,
  
    // Update tools
    updateTaskCompleteTool,
    updateTaskSnoozeDateTool,
    updateTaskBacklogTool,
    updateTaskPlannedTimeTool,
    updateTaskNotesTool,
    updateTaskDueDateTool,
    updateTaskTextTool,
    updateTaskStreamTool,
  ];