@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/task/task-delete.js

@@ -0,0 +1,70 @@
+/**
+ * task_delete - Delete a task
+ *
+ * Permanently deletes a task from FreshBooks.
+ * WARNING: This is irreversible. Consider using task_update with visState=1 to archive instead.
+ */
+import { TaskDeleteInputSchema, DeleteSuccessSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+/**
+ * Tool definition for task_delete
+ */
+export const taskDeleteTool = {
+    name: 'task_delete',
+    description: `Delete a task from FreshBooks.
+
+WHEN TO USE:
+- Need to permanently remove a task
+- Cleaning up test/duplicate tasks
+- Removing incorrectly created tasks
+
+REQUIRED INFO:
+- accountId: FreshBooks account ID
+- taskId: Task ID (numeric identifier)
+
+IMPORTANT WARNINGS:
+- This is PERMANENT and IRREVERSIBLE
+- Cannot recover deleted tasks
+- Consider using task_update with visState=1 to archive instead
+- Deleted tasks cannot be used in new time entries
+- Existing time entries with this task will retain the reference
+
+RETURNS:
+Success confirmation:
+- success: true if deleted
+- message: Confirmation message
+
+EXAMPLE PROMPTS:
+- "Delete task 12345"
+- "Remove task ID 789"
+- "Permanently delete the Testing task"
+
+BEST PRACTICE:
+⚠️ ARCHIVE INSTEAD: Use task_update with visState=1 to soft-delete tasks.
+This preserves data integrity while hiding the task from active lists.
+
+DELETE ONLY IF:
+- Task was created by mistake
+- Task has no time entries associated
+- You're absolutely certain it should be removed`,
+    inputSchema: TaskDeleteInputSchema,
+    outputSchema: DeleteSuccessSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('task_delete', async (input, _context) => {
+            const { accountId, taskId } = input;
+            await client.executeWithRetry('task_delete', async (fbClient) => {
+                const response = await fbClient.tasks.delete(accountId, taskId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            return {
+                success: true,
+                message: `Task ${taskId} has been permanently deleted`,
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=task-delete.js.map

package/dist/tools/task/task-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-delete.js","sourceRoot":"","sources":["../../../src/tools/task/task-delete.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAmCkC;IAE/C,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,mBAAmB;IAEjC,KAAK,CAAC,OAAO,CACX,KAA4C,EAC5C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,aAAa,EACb,KAAK,EAAE,KAA4C,EAAE,QAAqB,EAAE,EAAE;YAC5E,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;YAEpC,MAAM,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC9D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAEhE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,QAAQ,MAAM,+BAA+B;aACvD,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/tools/task/task-list.d.ts

@@ -0,0 +1,157 @@
+/**
+ * task_list - List all tasks
+ *
+ * Retrieves project tasks for detailed time tracking.
+ */
+import { z } from 'zod';
+import { TaskListOutputSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+declare const InputSchema: z.ZodObject<{
+    accountId: z.ZodString;
+} & {
+    page: z.ZodDefault<z.ZodNumber>;
+    perPage: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    page: number;
+    perPage: number;
+}, {
+    accountId: string;
+    page?: number | undefined;
+    perPage?: number | undefined;
+}>;
+/**
+ * Tool definition for task_list
+ */
+export declare const taskListTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+    } & {
+        page: z.ZodDefault<z.ZodNumber>;
+        perPage: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        page: number;
+        perPage: number;
+    }, {
+        accountId: string;
+        page?: number | undefined;
+        perPage?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        tasks: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodNumber>;
+            taskid: z.ZodOptional<z.ZodNumber>;
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            tname: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            tdesc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            billable: z.ZodOptional<z.ZodBoolean>;
+            rate: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>>;
+            visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            updated: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            description?: string | null | undefined;
+            name?: string | null | undefined;
+            id?: number | undefined;
+            billable?: boolean | undefined;
+            rate?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            taskid?: number | undefined;
+            tname?: string | null | undefined;
+            tdesc?: string | null | undefined;
+            visState?: 0 | 1 | 2 | undefined;
+            updated?: string | undefined;
+        }, {
+            description?: string | null | undefined;
+            name?: string | null | undefined;
+            id?: number | undefined;
+            billable?: boolean | undefined;
+            rate?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            taskid?: number | undefined;
+            tname?: string | null | undefined;
+            tdesc?: string | null | undefined;
+            visState?: 0 | 1 | 2 | undefined;
+            updated?: string | undefined;
+        }>, "many">;
+        pagination: z.ZodObject<{
+            page: z.ZodNumber;
+            pages: z.ZodNumber;
+            total: z.ZodNumber;
+            perPage: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        }, {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        tasks: {
+            description?: string | null | undefined;
+            name?: string | null | undefined;
+            id?: number | undefined;
+            billable?: boolean | undefined;
+            rate?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            taskid?: number | undefined;
+            tname?: string | null | undefined;
+            tdesc?: string | null | undefined;
+            visState?: 0 | 1 | 2 | undefined;
+            updated?: string | undefined;
+        }[];
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+    }, {
+        tasks: {
+            description?: string | null | undefined;
+            name?: string | null | undefined;
+            id?: number | undefined;
+            billable?: boolean | undefined;
+            rate?: {
+                code: string;
+                amount: string;
+            } | undefined;
+            taskid?: number | undefined;
+            tname?: string | null | undefined;
+            tdesc?: string | null | undefined;
+            visState?: 0 | 1 | 2 | undefined;
+            updated?: string | undefined;
+        }[];
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+    }>;
+    execute(input: z.infer<typeof InputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof TaskListOutputSchema>>;
+};
+export {};
+//# sourceMappingURL=task-list.d.ts.map

package/dist/tools/task/task-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.d.ts","sourceRoot":"","sources":["../../../src/tools/task/task-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,QAAA,MAAM,WAAW;;;;;;;;;;;;;EAEf,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAoCd,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,UAC1B,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;CAyCjD,CAAC"}

package/dist/tools/task/task-list.js

@@ -0,0 +1,78 @@
+/**
+ * task_list - List all tasks
+ *
+ * Retrieves project tasks for detailed time tracking.
+ */
+import { AccountIdSchema, PaginationSchema } from '../base-tool.js';
+import { TaskListOutputSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+const InputSchema = AccountIdSchema.extend({
+    ...PaginationSchema.shape,
+});
+/**
+ * Tool definition for task_list
+ */
+export const taskListTool = {
+    name: 'task_list',
+    description: `List tasks from FreshBooks.
+
+WHEN TO USE:
+- User wants to see project tasks
+- Need to find a task ID for time entry
+- Browse available task categories
+- Review task organization
+
+REQUIRED INFO:
+- accountId: FreshBooks account ID
+
+OPTIONAL PARAMETERS:
+- page: Page number for pagination (default: 1)
+- perPage: Results per page (default: 30, max: 100)
+
+RETURNS:
+Array of tasks with:
+- Task ID, name, description
+- Billable status and rate
+- Visibility state (active/archived)
+- Pagination metadata
+
+EXAMPLE PROMPTS:
+- "Show me all tasks"
+- "List project tasks"
+- "What tasks can I assign time to?"
+- "Get all billable tasks"
+
+NOTE: Tasks can have alternate field names (name/tname, description/tdesc) in the API.`,
+    inputSchema: InputSchema,
+    outputSchema: TaskListOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('task_list', async (input, _context) => {
+            const { accountId, page, perPage } = input;
+            const result = await client.executeWithRetry('task_list', async (fbClient) => {
+                const { PaginationQueryBuilder } = await import('@freshbooks/api/dist/models/builders/index.js');
+                // Build pagination query
+                const queryBuilders = [];
+                if (page || perPage) {
+                    queryBuilders.push(new PaginationQueryBuilder().page(page ?? 1).perPage(perPage ?? 30));
+                }
+                // Call FreshBooks API
+                const response = await fbClient.tasks.list(accountId, queryBuilders);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            return {
+                tasks: result.tasks || [],
+                pagination: result.pages || {
+                    page: 1,
+                    pages: 1,
+                    total: result.tasks?.length || 0,
+                    perPage: perPage ?? 30,
+                },
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=task-list.js.map

package/dist/tools/task/task-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.js","sourceRoot":"","sources":["../../../src/tools/task/task-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC;IACzC,GAAG,gBAAgB,CAAC,KAAK;CAC1B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;uFA4BwE;IAErF,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,oBAAoB;IAElC,KAAK,CAAC,OAAO,CACX,KAAkC,EAClC,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,WAAW,EACX,KAAK,EAAE,KAAkC,EAAE,QAAqB,EAAE,EAAE;YAClE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;YAE3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC3E,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAC7C,+CAA+C,CAChD,CAAC;gBAEF,yBAAyB;gBACzB,MAAM,aAAa,GAAG,EAAE,CAAC;gBACzB,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;oBACpB,aAAa,CAAC,IAAI,CAAC,IAAI,sBAAsB,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC1F,CAAC;gBAED,sBAAsB;gBACtB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBAErE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,KAAK,EAAG,MAAc,CAAC,KAAK,IAAI,EAAE;gBAClC,UAAU,EAAG,MAAc,CAAC,KAAK,IAAI;oBACnC,IAAI,EAAE,CAAC;oBACP,KAAK,EAAE,CAAC;oBACR,KAAK,EAAG,MAAc,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;oBACzC,OAAO,EAAE,OAAO,IAAI,EAAE;iBACvB;aACF,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/tools/task/task-single.d.ts

@@ -0,0 +1,77 @@
+/**
+ * task_single - Get a single task by ID
+ *
+ * Retrieves detailed information for a specific task.
+ */
+import { z } from 'zod';
+import { TaskSingleInputSchema, TaskSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for task_single
+ */
+export declare const taskSingleTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+    } & {
+        taskId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        taskId: number;
+    }, {
+        accountId: string;
+        taskId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
+        taskid: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        tname: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        tdesc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        billable: z.ZodOptional<z.ZodBoolean>;
+        rate: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        updated: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: number | undefined;
+        billable?: boolean | undefined;
+        rate?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        taskid?: number | undefined;
+        tname?: string | null | undefined;
+        tdesc?: string | null | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+        updated?: string | undefined;
+    }, {
+        description?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: number | undefined;
+        billable?: boolean | undefined;
+        rate?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        taskid?: number | undefined;
+        tname?: string | null | undefined;
+        tdesc?: string | null | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+        updated?: string | undefined;
+    }>;
+    execute(input: z.infer<typeof TaskSingleInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof TaskSchema>>;
+};
+//# sourceMappingURL=task-single.d.ts.map

package/dist/tools/task/task-single.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-single.d.ts","sourceRoot":"","sources":["../../../src/tools/task/task-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAiChB,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,UACpC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;CAsBvC,CAAC"}

package/dist/tools/task/task-single.js

@@ -0,0 +1,56 @@
+/**
+ * task_single - Get a single task by ID
+ *
+ * Retrieves detailed information for a specific task.
+ */
+import { TaskSingleInputSchema, TaskSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+/**
+ * Tool definition for task_single
+ */
+export const taskSingleTool = {
+    name: 'task_single',
+    description: `Get a single task by ID from FreshBooks.
+
+WHEN TO USE:
+- Need detailed information about a specific task
+- Verify task settings before using
+- Check task rate and billable status
+- Confirm task exists
+
+REQUIRED INFO:
+- accountId: FreshBooks account ID
+- taskId: Task ID (numeric identifier)
+
+RETURNS:
+Complete task details including:
+- Task ID, name, description
+- Billable status and rate
+- Visibility state
+- Last update timestamp
+
+EXAMPLE PROMPTS:
+- "Get details for task 12345"
+- "Show me task information for ID 789"
+- "What is task 456 used for?"
+- "Check if task 123 is billable"
+
+NOTE: Task names may appear in either 'name' or 'tname' field due to API variations.`,
+    inputSchema: TaskSingleInputSchema,
+    outputSchema: TaskSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('task_single', async (input, _context) => {
+            const { accountId, taskId } = input;
+            const result = await client.executeWithRetry('task_single', async (fbClient) => {
+                const response = await fbClient.tasks.single(accountId, taskId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            return result;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=task-single.js.map

package/dist/tools/task/task-single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-single.js","sourceRoot":"","sources":["../../../src/tools/task/task-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;qFAyBsE;IAEnF,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,UAAU;IAExB,KAAK,CAAC,OAAO,CACX,KAA4C,EAC5C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,aAAa,EACb,KAAK,EAAE,KAA4C,EAAE,QAAqB,EAAE,EAAE;YAC5E,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;YAEpC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC7E,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAEhE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,OAAO,MAA+C,CAAC;QACzD,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/tools/task/task-update.d.ts

@@ -0,0 +1,107 @@
+/**
+ * task_update - Update an existing task
+ *
+ * Modifies task details including name, description, rate, and billable status.
+ */
+import { z } from 'zod';
+import { TaskUpdateInputSchema, TaskSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for task_update
+ */
+export declare const taskUpdateTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+    } & {
+        taskId: z.ZodNumber;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        billable: z.ZodOptional<z.ZodBoolean>;
+        rate: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        taskId: number;
+        description?: string | undefined;
+        name?: string | undefined;
+        billable?: boolean | undefined;
+        rate?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+    }, {
+        accountId: string;
+        taskId: number;
+        description?: string | undefined;
+        name?: string | undefined;
+        billable?: boolean | undefined;
+        rate?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
+        taskid: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        tname: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        tdesc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        billable: z.ZodOptional<z.ZodBoolean>;
+        rate: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        updated: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: number | undefined;
+        billable?: boolean | undefined;
+        rate?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        taskid?: number | undefined;
+        tname?: string | null | undefined;
+        tdesc?: string | null | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+        updated?: string | undefined;
+    }, {
+        description?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: number | undefined;
+        billable?: boolean | undefined;
+        rate?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        taskid?: number | undefined;
+        tname?: string | null | undefined;
+        tdesc?: string | null | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+        updated?: string | undefined;
+    }>;
+    execute(input: z.infer<typeof TaskUpdateInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof TaskSchema>>;
+};
+//# sourceMappingURL=task-update.d.ts.map

package/dist/tools/task/task-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-update.d.ts","sourceRoot":"","sources":["../../../src/tools/task/task-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBA+ChB,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,UACpC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;CAyCvC,CAAC"}

package/dist/tools/task/task-update.js

@@ -0,0 +1,87 @@
+/**
+ * task_update - Update an existing task
+ *
+ * Modifies task details including name, description, rate, and billable status.
+ */
+import { TaskUpdateInputSchema, TaskSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+/**
+ * Tool definition for task_update
+ */
+export const taskUpdateTool = {
+    name: 'task_update',
+    description: `Update an existing task in FreshBooks.
+
+WHEN TO USE:
+- Need to change task name or description
+- Update billing rate for a task
+- Change billable status
+- Archive a task (set visState)
+
+REQUIRED INFO:
+- accountId: FreshBooks account ID
+- taskId: Task ID (numeric identifier)
+
+OPTIONAL PARAMETERS (at least one required):
+- name: Updated task name
+- description: Updated task description
+- billable: Updated billable status
+- rate: Updated billing rate
+  - amount: Decimal string (e.g., "60.00")
+  - code: Currency code
+- visState: Visibility state (0=active, 1=deleted, 2=archived)
+
+RETURNS:
+Updated task with:
+- Task ID (unchanged)
+- New name, description, rate
+- Updated billable status
+- Updated visibility state
+
+EXAMPLE PROMPTS:
+- "Update task 123 to be non-billable"
+- "Change task 456 name to Development Work"
+- "Set task 789 rate to $85/hour"
+- "Archive task 234"
+- "Update task 567 description to include meetings"
+
+BEST PRACTICES:
+- Use visState to archive rather than delete
+- Update rates when billing changes
+- Keep task names and descriptions current
+- Mark internal tasks as non-billable`,
+    inputSchema: TaskUpdateInputSchema,
+    outputSchema: TaskSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('task_update', async (input, _context) => {
+            const { accountId, taskId, name, description, billable, rate, visState } = input;
+            const result = await client.executeWithRetry('task_update', async (fbClient) => {
+                // Build update data with only provided fields
+                const updateData = {};
+                if (name !== undefined) {
+                    updateData.name = name;
+                }
+                if (description !== undefined) {
+                    updateData.description = description;
+                }
+                if (billable !== undefined) {
+                    updateData.billable = billable;
+                }
+                if (rate !== undefined) {
+                    updateData.rate = rate;
+                }
+                if (visState !== undefined) {
+                    updateData.visState = visState;
+                }
+                const response = await fbClient.tasks.update(updateData, accountId, taskId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            return result;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=task-update.js.map

package/dist/tools/task/task-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-update.js","sourceRoot":"","sources":["../../../src/tools/task/task-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCAuCuB;IAEpC,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,UAAU;IAExB,KAAK,CAAC,OAAO,CACX,KAA4C,EAC5C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,aAAa,EACb,KAAK,EAAE,KAA4C,EAAE,QAAqB,EAAE,EAAE;YAC5E,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;YAEjF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC7E,8CAA8C;gBAC9C,MAAM,UAAU,GAAwB,EAAE,CAAC;gBAE3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;gBACzB,CAAC;gBACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC9B,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;gBACvC,CAAC;gBACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBACjC,CAAC;gBACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;gBACzB,CAAC;gBACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBACjC,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,UAAiB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBAEnF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,OAAO,MAA+C,CAAC;QACzD,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/tools/time-entry/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * TimeEntry Tools
+ *
+ * Exports all time entry tools for FreshBooks MCP server.
+ */
+export { timeentryListTool } from './timeentry-list.js';
+export { timeentrySingleTool } from './timeentry-single.js';
+export { timeentryCreateTool } from './timeentry-create.js';
+export { timeentryUpdateTool } from './timeentry-update.js';
+export { timeentryDeleteTool } from './timeentry-delete.js';
+//# sourceMappingURL=index.d.ts.map