@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/time-entry/schemas.js

@@ -0,0 +1,217 @@
+/**
+ * TimeEntry Zod Schemas
+ *
+ * Type-safe schemas for TimeEntry operations.
+ * Maps directly to FreshBooks TimeEntry API.
+ */
+import { z } from 'zod';
+import { createSortSchema, createIncludesSchema } from '../base-tool.js';
+/**
+ * TimeEntry sortable fields
+ */
+export const TIMEENTRY_SORTABLE_FIELDS = [
+    'started_at',
+    'created_at',
+    'duration',
+];
+/**
+ * TimeEntry sort field descriptions
+ */
+export const TIMEENTRY_SORT_FIELD_DESCRIPTIONS = {
+    started_at: 'When the time entry started',
+    created_at: 'When the entry was created in FreshBooks',
+    duration: 'Length of the time entry in seconds',
+};
+/**
+ * TimeEntry include options
+ */
+export const TIMEENTRY_INCLUDE_OPTIONS = [
+    'client',
+    'project',
+    'task',
+    'service',
+];
+/**
+ * TimeEntry include option descriptions
+ */
+export const TIMEENTRY_INCLUDE_DESCRIPTIONS = {
+    client: 'Client details associated with the time entry',
+    project: 'Project details for the time entry',
+    task: 'Task information if assigned',
+    service: 'Service type used for billing categorization',
+};
+/**
+ * TimeEntry sort schema
+ */
+export const TimeEntrySortSchema = createSortSchema(TIMEENTRY_SORTABLE_FIELDS, TIMEENTRY_SORT_FIELD_DESCRIPTIONS);
+/**
+ * TimeEntry includes schema
+ */
+export const TimeEntryIncludesSchema = createIncludesSchema(TIMEENTRY_INCLUDE_OPTIONS, TIMEENTRY_INCLUDE_DESCRIPTIONS);
+/**
+ * Timer schema (embedded in TimeEntry)
+ */
+export const TimerSchema = z.object({
+    id: z.number().optional(),
+    isRunning: z.boolean().nullable().optional(),
+});
+/**
+ * Full TimeEntry entity schema
+ */
+export const TimeEntrySchema = z.object({
+    id: z.number().optional(),
+    identityId: z.number().optional(),
+    isLogged: z.boolean(),
+    startedAt: z.string().datetime(),
+    createdAt: z.string().datetime().optional(),
+    clientId: z.number().nullable().optional(),
+    projectId: z.number().nullable().optional(),
+    pendingClient: z.string().nullable().optional(),
+    pendingProject: z.string().nullable().optional(),
+    pendingTask: z.string().nullable().optional(),
+    taskId: z.number().nullable().optional(),
+    serviceId: z.number().nullable().optional(),
+    note: z.string().nullable().optional(),
+    active: z.boolean().optional(),
+    billable: z.boolean().optional(),
+    billed: z.boolean().optional(),
+    internal: z.boolean().optional(),
+    retainerId: z.number().nullable().optional(),
+    duration: z.number(),
+    timer: TimerSchema.nullable().optional(),
+});
+/**
+ * Input schema for creating a time entry
+ */
+export const TimeEntryCreateInputSchema = z.object({
+    businessId: z.number().int().positive().describe('FreshBooks business ID (get from user_me -> businessMemberships[].business.id)'),
+    duration: z.number().min(0).describe('Duration in seconds (0 for active timer)'),
+    isLogged: z.boolean().default(true).describe('Whether time is logged (false for active timer)'),
+    startedAt: z
+        .string()
+        .datetime()
+        .optional()
+        .describe('Start time (ISO 8601). Defaults to now if not specified'),
+    note: z.string().optional().describe('Description of work performed'),
+    projectId: z.number().optional().describe('Associated project ID'),
+    clientId: z.number().optional().describe('Associated client ID'),
+    serviceId: z.number().optional().describe('Associated service ID'),
+    taskId: z.number().optional().describe('Associated task ID'),
+    billable: z.boolean().optional().describe('Whether time is billable'),
+    active: z.boolean().default(false).describe('Whether this is an active timer'),
+    internal: z.boolean().optional().describe('Whether this is internal work'),
+    retainerId: z.number().optional().describe('Associated retainer ID'),
+});
+/**
+ * Input schema for updating a time entry
+ */
+export const TimeEntryUpdateInputSchema = z.object({
+    businessId: z.number().int().positive().describe('FreshBooks business ID (get from user_me -> businessMemberships[].business.id)'),
+    timeEntryId: z.number().describe('Time entry ID to update'),
+    duration: z.number().min(0).optional().describe('Duration in seconds'),
+    isLogged: z.boolean().optional().describe('Whether time is logged'),
+    startedAt: z.string().datetime().optional().describe('Start time (ISO 8601)'),
+    note: z.string().optional().describe('Description of work performed'),
+    projectId: z.number().nullable().optional().describe('Associated project ID'),
+    clientId: z.number().nullable().optional().describe('Associated client ID'),
+    serviceId: z.number().nullable().optional().describe('Associated service ID'),
+    taskId: z.number().nullable().optional().describe('Associated task ID'),
+    billable: z.boolean().optional().describe('Whether time is billable'),
+    active: z.boolean().optional().describe('Whether this is an active timer'),
+    internal: z.boolean().optional().describe('Whether this is internal work'),
+    retainerId: z.number().nullable().optional().describe('Associated retainer ID'),
+});
+/**
+ * Input schema for listing time entries
+ */
+export const TimeEntryListInputSchema = z.object({
+    businessId: z.number().int().positive().describe('FreshBooks business ID (get from user_me -> businessMemberships[].business.id)'),
+    page: z.number().int().min(1).default(1).optional().describe('Page number (1-indexed)'),
+    perPage: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(30)
+        .optional()
+        .describe('Number of results per page (max 100)'),
+    // Search filters
+    projectId: z.number().optional().describe('Filter by project ID'),
+    clientId: z.number().optional().describe('Filter by client ID'),
+    taskId: z.number().optional().describe('Filter by task ID'),
+    serviceId: z.number().optional().describe('Filter by service ID'),
+    active: z.boolean().optional().describe('Filter by active status (running timers)'),
+    billable: z.boolean().optional().describe('Filter by billable status'),
+    billed: z.boolean().optional().describe('Filter by billed status'),
+    startedAfter: z
+        .string()
+        .optional()
+        .describe('Filter entries started after this date (YYYY-MM-DD or ISO 8601 datetime)')
+        .transform((val) => {
+        if (!val)
+            return val;
+        // If just a date, append midnight UTC
+        if (/^\d{4}-\d{2}-\d{2}$/.test(val)) {
+            return `${val}T00:00:00Z`;
+        }
+        return val;
+    }),
+    startedBefore: z
+        .string()
+        .optional()
+        .describe('Filter entries started before this date (YYYY-MM-DD or ISO 8601 datetime)')
+        .transform((val) => {
+        if (!val)
+            return val;
+        // If just a date, append end of day UTC
+        if (/^\d{4}-\d{2}-\d{2}$/.test(val)) {
+            return `${val}T23:59:59Z`;
+        }
+        return val;
+    }),
+})
+    .merge(TimeEntrySortSchema)
+    .merge(TimeEntryIncludesSchema);
+/**
+ * Input schema for getting a single time entry
+ */
+export const TimeEntrySingleInputSchema = z.object({
+    businessId: z.number().int().positive().describe('FreshBooks business ID (get from user_me -> businessMemberships[].business.id)'),
+    timeEntryId: z.number().describe('Time entry ID to retrieve'),
+});
+/**
+ * Input schema for deleting a time entry
+ */
+export const TimeEntryDeleteInputSchema = z.object({
+    businessId: z.number().int().positive().describe('FreshBooks business ID (get from user_me -> businessMemberships[].business.id)'),
+    timeEntryId: z.number().describe('Time entry ID to delete'),
+});
+/**
+ * Pagination metadata schema
+ */
+export const PaginationSchema = z.object({
+    page: z.number(),
+    pages: z.number(),
+    perPage: z.number(),
+    total: z.number(),
+});
+/**
+ * Output schema for list operations
+ */
+export const TimeEntryListOutputSchema = z.object({
+    timeEntries: z.array(TimeEntrySchema),
+    pagination: PaginationSchema,
+});
+/**
+ * Output schema for single/create/update operations
+ */
+export const TimeEntrySingleOutputSchema = TimeEntrySchema;
+/**
+ * Output schema for delete operations
+ */
+export const TimeEntryDeleteOutputSchema = z.object({
+    success: z.boolean(),
+    message: z.string(),
+    timeEntryId: z.number(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/time-entry/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/time-entry/schemas.ts"],"names":[],"mappings":"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"}

package/dist/tools/time-entry/timeentry-create.d.ts

@@ -0,0 +1,142 @@
+/**
+ * timeentry_create Tool
+ *
+ * Create a new time entry in FreshBooks.
+ */
+import { z } from 'zod';
+import { TimeEntryCreateInputSchema, TimeEntrySingleOutputSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for timeentry_create
+ */
+export declare const timeentryCreateTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+        duration: z.ZodNumber;
+        isLogged: z.ZodDefault<z.ZodBoolean>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodNumber>;
+        clientId: z.ZodOptional<z.ZodNumber>;
+        serviceId: z.ZodOptional<z.ZodNumber>;
+        taskId: z.ZodOptional<z.ZodNumber>;
+        billable: z.ZodOptional<z.ZodBoolean>;
+        active: z.ZodDefault<z.ZodBoolean>;
+        internal: z.ZodOptional<z.ZodBoolean>;
+        retainerId: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        businessId: number;
+        duration: number;
+        isLogged: boolean;
+        active: boolean;
+        taskId?: number | undefined;
+        startedAt?: string | undefined;
+        clientId?: number | undefined;
+        projectId?: number | undefined;
+        serviceId?: number | undefined;
+        note?: string | undefined;
+        billable?: boolean | undefined;
+        internal?: boolean | undefined;
+        retainerId?: number | undefined;
+    }, {
+        businessId: number;
+        duration: number;
+        taskId?: number | undefined;
+        isLogged?: boolean | undefined;
+        startedAt?: string | undefined;
+        clientId?: number | undefined;
+        projectId?: number | undefined;
+        serviceId?: number | undefined;
+        note?: string | undefined;
+        active?: boolean | undefined;
+        billable?: boolean | undefined;
+        internal?: boolean | undefined;
+        retainerId?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
+        identityId: z.ZodOptional<z.ZodNumber>;
+        isLogged: z.ZodBoolean;
+        startedAt: z.ZodString;
+        createdAt: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        projectId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        pendingClient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pendingProject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pendingTask: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        taskId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        serviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        active: z.ZodOptional<z.ZodBoolean>;
+        billable: z.ZodOptional<z.ZodBoolean>;
+        billed: z.ZodOptional<z.ZodBoolean>;
+        internal: z.ZodOptional<z.ZodBoolean>;
+        retainerId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        duration: z.ZodNumber;
+        timer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodOptional<z.ZodNumber>;
+            isRunning: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            id?: number | undefined;
+            isRunning?: boolean | null | undefined;
+        }, {
+            id?: number | undefined;
+            isRunning?: boolean | null | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        duration: number;
+        isLogged: boolean;
+        startedAt: string;
+        billed?: boolean | undefined;
+        taskId?: number | null | undefined;
+        createdAt?: string | undefined;
+        id?: number | undefined;
+        identityId?: number | undefined;
+        clientId?: number | null | undefined;
+        projectId?: number | null | undefined;
+        pendingClient?: string | null | undefined;
+        pendingProject?: string | null | undefined;
+        pendingTask?: string | null | undefined;
+        serviceId?: number | null | undefined;
+        note?: string | null | undefined;
+        active?: boolean | undefined;
+        billable?: boolean | undefined;
+        internal?: boolean | undefined;
+        retainerId?: number | null | undefined;
+        timer?: {
+            id?: number | undefined;
+            isRunning?: boolean | null | undefined;
+        } | null | undefined;
+    }, {
+        duration: number;
+        isLogged: boolean;
+        startedAt: string;
+        billed?: boolean | undefined;
+        taskId?: number | null | undefined;
+        createdAt?: string | undefined;
+        id?: number | undefined;
+        identityId?: number | undefined;
+        clientId?: number | null | undefined;
+        projectId?: number | null | undefined;
+        pendingClient?: string | null | undefined;
+        pendingProject?: string | null | undefined;
+        pendingTask?: string | null | undefined;
+        serviceId?: number | null | undefined;
+        note?: string | null | undefined;
+        active?: boolean | undefined;
+        billable?: boolean | undefined;
+        internal?: boolean | undefined;
+        retainerId?: number | null | undefined;
+        timer?: {
+            id?: number | undefined;
+            isRunning?: boolean | null | undefined;
+        } | null | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof TimeEntryCreateInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof TimeEntrySingleOutputSchema>>;
+};
+//# sourceMappingURL=timeentry-create.d.ts.map

package/dist/tools/time-entry/timeentry-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeentry-create.d.ts","sourceRoot":"","sources":["../../../src/tools/time-entry/timeentry-create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAKhE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwD9B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,UACzC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;CA0FxD,CAAC"}

package/dist/tools/time-entry/timeentry-create.js

@@ -0,0 +1,137 @@
+/**
+ * timeentry_create Tool
+ *
+ * Create a new time entry in FreshBooks.
+ */
+import { TimeEntryCreateInputSchema, TimeEntrySingleOutputSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Tool definition for timeentry_create
+ */
+export const timeentryCreateTool = {
+    name: 'timeentry_create',
+    description: `Create a new time entry in FreshBooks.
+
+WHEN TO USE:
+- User says "log my time", "track time", "record hours", "add time entry"
+- User mentions working on a project with duration
+- User wants to record billable or non-billable time
+- User asks "log 2 hours on project X", "track 45 minutes of work"
+
+REQUIRED:
+- businessId: FreshBooks business ID (get from user_me -> businessMemberships[].business.id)
+- duration: Time in seconds (or ask user for hours/minutes and convert)
+  * 1 hour = 3600 seconds
+  * 1 minute = 60 seconds
+  * Example: 2 hours 30 minutes = 9000 seconds
+
+OPTIONAL BUT RECOMMENDED:
+- note: Description of work performed (improves billing accuracy)
+- projectId: Associate with a project
+- clientId: Associate with a client
+- serviceId: Service type for billing categorization
+- taskId: Associate with a task
+- billable: Whether time is billable (default: true if isLogged=true)
+- startedAt: When work began (ISO 8601 format, defaults to now)
+- isLogged: Whether time is logged (default: true)
+  * Set to false for active timers (with duration=0 and active=true)
+
+SPECIAL CASES:
+- To start a timer: Set duration=0, active=true, isLogged=false
+- For completed work: Set duration to actual seconds, isLogged=true
+
+RETURNS:
+Created time entry with:
+- id: New time entry ID (save this for updates/deletes)
+- duration: Confirmed duration in seconds
+- All other time entry fields
+
+EXAMPLES:
+User says: "Log 2 hours on Project Alpha for code review"
+→ duration: 7200 (2 * 3600)
+→ note: "code review"
+→ projectId: (look up Project Alpha)
+
+User says: "Track 45 minutes of meeting time"
+→ duration: 2700 (45 * 60)
+→ note: "meeting"
+
+User says: "Record 3 hours of development work for client ABC"
+→ duration: 10800 (3 * 3600)
+→ note: "development work"
+→ clientId: (look up client ABC)`,
+    inputSchema: TimeEntryCreateInputSchema,
+    outputSchema: TimeEntrySingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('timeentry_create', async (input, _context) => {
+            logger.debug('Creating time entry', {
+                businessId: input.businessId,
+                duration: input.duration,
+                projectId: input.projectId,
+                isLogged: input.isLogged,
+            });
+            const result = await client.executeWithRetry('timeentry_create', async (fbClient) => {
+                // Build time entry data object
+                const timeEntryData = {
+                    duration: input.duration,
+                    isLogged: input.isLogged,
+                };
+                // Add startedAt (default to now if not specified)
+                if (input.startedAt) {
+                    timeEntryData.startedAt = new Date(input.startedAt);
+                }
+                else {
+                    timeEntryData.startedAt = new Date();
+                }
+                // Add optional fields if provided
+                if (input.note !== undefined) {
+                    timeEntryData.note = input.note;
+                }
+                if (input.projectId !== undefined) {
+                    timeEntryData.projectId = input.projectId;
+                }
+                if (input.clientId !== undefined) {
+                    timeEntryData.clientId = input.clientId;
+                }
+                if (input.serviceId !== undefined) {
+                    timeEntryData.serviceId = input.serviceId;
+                }
+                if (input.taskId !== undefined) {
+                    timeEntryData.taskId = input.taskId;
+                }
+                if (input.billable !== undefined) {
+                    timeEntryData.billable = input.billable;
+                }
+                if (input.active !== undefined) {
+                    timeEntryData.active = input.active;
+                }
+                if (input.internal !== undefined) {
+                    timeEntryData.internal = input.internal;
+                }
+                if (input.retainerId !== undefined) {
+                    timeEntryData.retainerId = input.retainerId;
+                }
+                const response = await fbClient.timeEntries.create(timeEntryData, input.businessId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                if (!response.data) {
+                    throw ErrorHandler.createValidationError('Failed to create time entry: No data returned from API');
+                }
+                return response.data;
+            });
+            logger.info('Time entry created successfully', {
+                timeEntryId: result.id,
+                duration: result.duration,
+                isLogged: result.isLogged,
+            });
+            return result;
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+//# sourceMappingURL=timeentry-create.js.map

package/dist/tools/time-entry/timeentry-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeentry-create.js","sourceRoot":"","sources":["../../../src/tools/time-entry/timeentry-create.ts"],"names":[],"mappings":"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"}

package/dist/tools/time-entry/timeentry-delete.d.ts

@@ -0,0 +1,43 @@
+/**
+ * timeentry_delete Tool
+ *
+ * Delete a time entry from FreshBooks.
+ */
+import { z } from 'zod';
+import { TimeEntryDeleteInputSchema, TimeEntryDeleteOutputSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for timeentry_delete
+ */
+export declare const timeentryDeleteTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+        timeEntryId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        businessId: number;
+        timeEntryId: number;
+    }, {
+        businessId: number;
+        timeEntryId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        success: z.ZodBoolean;
+        message: z.ZodString;
+        timeEntryId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        success: boolean;
+        timeEntryId: number;
+    }, {
+        message: string;
+        success: boolean;
+        timeEntryId: number;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof TimeEntryDeleteInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof TimeEntryDeleteOutputSchema>>;
+};
+//# sourceMappingURL=timeentry-delete.d.ts.map

package/dist/tools/time-entry/timeentry-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeentry-delete.d.ts","sourceRoot":"","sources":["../../../src/tools/time-entry/timeentry-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAKhE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;IAuD9B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,UACzC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;CAuCxD,CAAC"}

package/dist/tools/time-entry/timeentry-delete.js

@@ -0,0 +1,93 @@
+/**
+ * timeentry_delete Tool
+ *
+ * Delete a time entry from FreshBooks.
+ */
+import { TimeEntryDeleteInputSchema, TimeEntryDeleteOutputSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Tool definition for timeentry_delete
+ */
+export const timeentryDeleteTool = {
+    name: 'timeentry_delete',
+    description: `Delete a time entry from FreshBooks.
+
+WHEN TO USE:
+- User wants to remove a time entry completely
+- User says "delete time entry X", "remove entry Y", "discard this time log"
+- User made a mistake and wants to delete rather than update
+- User wants to discard a running timer without logging the time
+- User asks "delete entry 123", "remove that time entry"
+
+REQUIRED:
+- businessId: FreshBooks business ID (get from user_me -> businessMemberships[].business.id)
+- timeEntryId: ID of the time entry to delete
+
+IMPORTANT NOTES:
+- Deletion is permanent and cannot be undone
+- Use this to discard running timers without logging time
+- If time was already billed, deletion may affect invoices
+- Consider updating instead of deleting if you just need to change values
+
+USE CASES:
+1. Discard a running timer:
+   - Delete the active time entry to discard without logging
+
+2. Remove erroneous entry:
+   - Delete time entries created by mistake
+
+3. Clean up test data:
+   - Remove test or sample time entries
+
+ALTERNATIVE ACTIONS:
+- To change duration/project: Use timeentry_update instead
+- To make non-billable: Use timeentry_update with billable=false
+- To archive: FreshBooks doesn't support archiving (delete removes completely)
+
+RETURNS:
+Success confirmation with:
+- success: true/false
+- message: Confirmation message
+- timeEntryId: ID of the deleted entry
+
+EXAMPLES:
+User says: "Delete time entry 123"
+→ timeEntryId: 123
+
+User says: "Discard timer 456"
+→ timeEntryId: 456
+
+User says: "Remove that time entry I just created"
+→ (first get the time entry ID, then delete)`,
+    inputSchema: TimeEntryDeleteInputSchema,
+    outputSchema: TimeEntryDeleteOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('timeentry_delete', async (input, _context) => {
+            logger.debug('Deleting time entry', {
+                businessId: input.businessId,
+                timeEntryId: input.timeEntryId,
+            });
+            await client.executeWithRetry('timeentry_delete', async (fbClient) => {
+                const response = await fbClient.timeEntries.delete(input.businessId, input.timeEntryId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response;
+            });
+            logger.info('Time entry deleted successfully', {
+                timeEntryId: input.timeEntryId,
+            });
+            return {
+                success: true,
+                message: `Time entry ${input.timeEntryId} deleted successfully`,
+                timeEntryId: input.timeEntryId,
+            };
+        });
+        return handler(input, { businessId: input.businessId, entityId: input.timeEntryId });
+    },
+};
+//# sourceMappingURL=timeentry-delete.js.map

package/dist/tools/time-entry/timeentry-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeentry-delete.js","sourceRoot":"","sources":["../../../src/tools/time-entry/timeentry-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEvF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6CAgD8B;IAE3C,WAAW,EAAE,0BAA0B;IACvC,YAAY,EAAE,2BAA2B;IAEzC;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAiD,EACjD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,kBAAkB,EAClB,KAAK,EACH,KAAiD,EACjD,QAAqB,EACrB,EAAE;YACF,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE;gBAClC,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACnE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,MAAM,CAChD,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,WAAW,CAClB,CAAC;gBAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC;YAClB,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;gBAC7C,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,cAAc,KAAK,CAAC,WAAW,uBAAuB;gBAC/D,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACvF,CAAC;CACF,CAAC"}