@goodsamsoftware/freshbooks-mcp 1.0.6 → 1.0.8

package/dist/tools/client/client-create.js

@@ -11,44 +11,44 @@ import { logger } from '../../utils/logger.js';
  */
 export const clientCreateTool = {
     name: 'client_create',
-    description: `Create a new client/customer in FreshBooks.
-
-WHEN TO USE:
-- User wants to add a new client
-- User says "create client", "add customer", "new client"
-- Setting up a customer for invoicing or project tracking
-- Before creating invoices or projects for a new customer
-
-REQUIRED:
-- accountId: FreshBooks account ID (get from auth_status if not specified)
-- At least one of: fName, lName, organization, or email
-
-OPTIONAL:
-Contact:
-- fName, lName: Client's name
-- organization: Company name
-- email: Email address (recommended for invoices)
-
-Phone:
-- busPhone, homePhone, mobPhone, fax
-
-Address:
-- pStreet, pStreet2, pCity, pProvince, pCode, pCountry (primary)
-- sStreet, sStreet2, sCity, sProvince, sCode, sCountry (secondary)
-
-Settings:
-- currencyCode: e.g., USD, CAD, EUR
-- language: Preferred language for invoices
-- vatNumber, vatName: Tax identification
-- allowLateFees, allowLateNotifications: Billing preferences
-- note: Internal notes
-
-RETURNS:
-Created client with assigned ID and all configured settings.
-
-EXAMPLES:
-- "Create a new client: John Smith, john@example.com"
-- "Add client Acme Corp with email billing@acme.com"
+    description: `Create a new client/customer in FreshBooks.
+
+WHEN TO USE:
+- User wants to add a new client
+- User says "create client", "add customer", "new client"
+- Setting up a customer for invoicing or project tracking
+- Before creating invoices or projects for a new customer
+
+REQUIRED:
+- accountId: FreshBooks account ID (get from auth_status if not specified)
+- At least one of: fName, lName, organization, or email
+
+OPTIONAL:
+Contact:
+- fName, lName: Client's name
+- organization: Company name
+- email: Email address (recommended for invoices)
+
+Phone:
+- busPhone, homePhone, mobPhone, fax
+
+Address:
+- pStreet, pStreet2, pCity, pProvince, pCode, pCountry (primary)
+- sStreet, sStreet2, sCity, sProvince, sCode, sCountry (secondary)
+
+Settings:
+- currencyCode: e.g., USD, CAD, EUR
+- language: Preferred language for invoices
+- vatNumber, vatName: Tax identification
+- allowLateFees, allowLateNotifications: Billing preferences
+- note: Internal notes
+
+RETURNS:
+Created client with assigned ID and all configured settings.
+
+EXAMPLES:
+- "Create a new client: John Smith, john@example.com"
+- "Add client Acme Corp with email billing@acme.com"
 - "New client: Jane Doe, 123 Main St, New York, NY 10001"`,
     inputSchema: ClientCreateInputSchema,
     outputSchema: ClientSingleOutputSchema,

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

@@ -12,53 +12,53 @@ import { buildQueryBuilders } from '../base-tool.js';
  */
 export const clientListTool = {
     name: 'client_list',
-    description: `List clients from FreshBooks with optional filtering and pagination.
-
-WHEN TO USE:
-- User asks to "see clients", "list clients", "show all customers"
-- User wants to find a client by name, email, or organization
-- User needs to select a client for invoicing or project setup
-- Getting client information for time tracking context
-
-REQUIRED:
-- accountId: FreshBooks account ID (get from auth_status if not specified)
-
-OPTIONAL FILTERS:
-- email: Find client by exact email address
-- organization: Search by company name (partial match)
-- fName: Search by first name (partial match)
-- lName: Search by last name (partial match)
-- visState: Filter by status (0=active, 1=deleted, 2=archived)
-
-SORTING:
-- sortBy: Field to sort by (organization, fname, lname, email, updated)
-- sortOrder: Sort direction (asc or desc, default: desc)
-
-INCLUDES:
-- include: Related data to fetch (outstanding_balance, credit_balance)
-  - outstanding_balance: Total unpaid amount across all invoices
-  - credit_balance: Available credit for the client
-
-PAGINATION:
-- page: Page number (default: 1)
-- perPage: Results per page (default: 30, max: 100)
-
-RETURNS:
-Array of clients with:
-- id: Client ID
-- fName, lName: Contact name
-- organization: Company name
-- email: Email address
-- Phone numbers, addresses
-- currencyCode: Billing currency
-- visState: Status
-Plus pagination metadata (page, pages, total)
-
-EXAMPLES:
-- "Show me all active clients"
-- "List clients with 'Acme' in their organization name"
-- "Find the client with email john@example.com"
-- "Show all archived clients sorted by organization"
+    description: `List clients from FreshBooks with optional filtering and pagination.
+
+WHEN TO USE:
+- User asks to "see clients", "list clients", "show all customers"
+- User wants to find a client by name, email, or organization
+- User needs to select a client for invoicing or project setup
+- Getting client information for time tracking context
+
+REQUIRED:
+- accountId: FreshBooks account ID (get from auth_status if not specified)
+
+OPTIONAL FILTERS:
+- email: Find client by exact email address
+- organization: Search by company name (partial match)
+- fName: Search by first name (partial match)
+- lName: Search by last name (partial match)
+- visState: Filter by status (0=active, 1=deleted, 2=archived)
+
+SORTING:
+- sortBy: Field to sort by (organization, fname, lname, email, updated)
+- sortOrder: Sort direction (asc or desc, default: desc)
+
+INCLUDES:
+- include: Related data to fetch (outstanding_balance, credit_balance)
+  - outstanding_balance: Total unpaid amount across all invoices
+  - credit_balance: Available credit for the client
+
+PAGINATION:
+- page: Page number (default: 1)
+- perPage: Results per page (default: 30, max: 100)
+
+RETURNS:
+Array of clients with:
+- id: Client ID
+- fName, lName: Contact name
+- organization: Company name
+- email: Email address
+- Phone numbers, addresses
+- currencyCode: Billing currency
+- visState: Status
+Plus pagination metadata (page, pages, total)
+
+EXAMPLES:
+- "Show me all active clients"
+- "List clients with 'Acme' in their organization name"
+- "Find the client with email john@example.com"
+- "Show all archived clients sorted by organization"
 - "Get clients with their outstanding balances"`,
     inputSchema: ClientListInputSchema,
     outputSchema: ClientListOutputSchema,

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

@@ -11,40 +11,40 @@ import { logger } from '../../utils/logger.js';
  */
 export const clientUpdateTool = {
     name: 'client_update',
-    description: `Update an existing client's information in FreshBooks.
-
-WHEN TO USE:
-- User wants to modify client details
-- User says "update client", "change client info", "edit customer"
-- Correcting client contact information
-- Updating billing address or preferences
-- Changing client status (archive/activate)
-
-REQUIRED:
-- accountId: FreshBooks account ID (get from auth_status if not specified)
-- clientId: The client ID to update (numeric)
-- At least one field to update
-
-UPDATABLE FIELDS:
-Contact: fName, lName, organization, email
-Phones: busPhone, homePhone, mobPhone, fax
-Primary address: pStreet, pStreet2, pCity, pProvince, pCode, pCountry
-Secondary address: sStreet, sStreet2, sCity, sProvince, sCode, sCountry
-Financial: currencyCode, language, vatNumber, vatName
-Preferences: allowLateFees, allowLateNotifications
-Status: visState (0=active, 1=deleted, 2=archived)
-Notes: note
-
-PARTIAL UPDATES:
-Only include fields you want to change. Omitted fields remain unchanged.
-
-RETURNS:
-Updated client record with all current information.
-
-EXAMPLES:
-- "Update client 123's email to newemail@example.com"
-- "Change client 456's address to 789 Oak Street, Boston, MA"
-- "Archive client 789 (set visState to 2)"
+    description: `Update an existing client's information in FreshBooks.
+
+WHEN TO USE:
+- User wants to modify client details
+- User says "update client", "change client info", "edit customer"
+- Correcting client contact information
+- Updating billing address or preferences
+- Changing client status (archive/activate)
+
+REQUIRED:
+- accountId: FreshBooks account ID (get from auth_status if not specified)
+- clientId: The client ID to update (numeric)
+- At least one field to update
+
+UPDATABLE FIELDS:
+Contact: fName, lName, organization, email
+Phones: busPhone, homePhone, mobPhone, fax
+Primary address: pStreet, pStreet2, pCity, pProvince, pCode, pCountry
+Secondary address: sStreet, sStreet2, sCity, sProvince, sCode, sCountry
+Financial: currencyCode, language, vatNumber, vatName
+Preferences: allowLateFees, allowLateNotifications
+Status: visState (0=active, 1=deleted, 2=archived)
+Notes: note
+
+PARTIAL UPDATES:
+Only include fields you want to change. Omitted fields remain unchanged.
+
+RETURNS:
+Updated client record with all current information.
+
+EXAMPLES:
+- "Update client 123's email to newemail@example.com"
+- "Change client 456's address to 789 Oak Street, Boston, MA"
+- "Archive client 789 (set visState to 2)"
 - "Enable late fees for client 234"`,
     inputSchema: ClientUpdateInputSchema,
     outputSchema: ClientSingleOutputSchema,

package/dist/tools/credit-note/creditnote-single.js

@@ -10,24 +10,24 @@ import { ErrorHandler } from "../../errors/error-handler.js";
  */
 export const creditnoteSingleTool = {
     name: "creditnote_single",
-    description: `Retrieve a single credit note by ID from FreshBooks.
-
-WHEN TO USE:
-- User asks for details about a specific credit note
-- User provides a credit note ID or number
-- User needs to review credit note details before applying or updating
-
-REQUIRED INFO:
-- creditNoteId: The credit note identifier
-- accountId: FreshBooks account (get from context)
-
-EXAMPLE PROMPTS:
-- "Show me credit note #12345"
-- "Get details for credit note 67890"
-- "What's in credit note ID 555?"
-
-RETURNS:
-Complete credit note record including credit amount, client info, status,
+    description: `Retrieve a single credit note by ID from FreshBooks.
+
+WHEN TO USE:
+- User asks for details about a specific credit note
+- User provides a credit note ID or number
+- User needs to review credit note details before applying or updating
+
+REQUIRED INFO:
+- creditNoteId: The credit note identifier
+- accountId: FreshBooks account (get from context)
+
+EXAMPLE PROMPTS:
+- "Show me credit note #12345"
+- "Get details for credit note 67890"
+- "What's in credit note ID 555?"
+
+RETURNS:
+Complete credit note record including credit amount, client info, status,
 line items, and all other credit note properties.`,
     inputSchema: CreditNoteSingleInputSchema,
     outputSchema: CreditNoteSingleOutputSchema,

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

@@ -1 +1 @@
-{"version":3,"file":"expense-update.d.ts","sourceRoot":"","sources":["../../../src/tools/expense/expense-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAKhE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwC5B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,UACvC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;CAqHtD,CAAC"}
+{"version":3,"file":"expense-update.d.ts","sourceRoot":"","sources":["../../../src/tools/expense/expense-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAKhE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwC5B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,UACvC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;CAsHtD,CAAC"}

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

@@ -76,8 +76,9 @@ Updated expense with all current details.`,
                 const existing = existingExpense;
                 // Build expense update object with ONLY updatable fields
                 // Do NOT spread the entire object - API returns extra read-only fields
-                // (accountId, isDuplicate, profileId, bankName, status, updated, hasReceipt, etc.)
                 // that cause the SDK to hang if included in update requests
+                // NOTE: visState is intentionally NOT copied from existing - including it causes
+                // the SDK to hang. Only include visState if user explicitly provides it.
                 const expense = {
                     categoryId: existing.categoryId,
                     staffId: existing.staffId,
@@ -92,7 +93,7 @@ Updated expense with all current details.`,
                     taxPercent1: existing.taxPercent1,
                     taxName2: existing.taxName2,
                     taxPercent2: existing.taxPercent2,
-                    visState: existing.visState,
+                    // visState intentionally omitted - causes SDK hang when copied
                 };
                 // Overlay only the fields user provided
                 if (updateData.categoryId !== undefined)
@@ -119,8 +120,7 @@ Updated expense with all current details.`,
                     expense.taxName2 = updateData.taxName2;
                 if (updateData.taxPercent2 !== undefined)
                     expense.taxPercent2 = updateData.taxPercent2;
-                if (updateData.visState !== undefined)
-                    expense.visState = updateData.visState;
+                //if (updateData.visState !== undefined) expense.visState = updateData.visState;
                 // Validate that at least one field is being updated
                 const updatedFields = Object.keys(updateData).filter((k) => updateData[k] !== undefined);
                 if (updatedFields.length === 0) {

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

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

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

@@ -12,46 +12,46 @@ import { buildQueryBuilders } from '../base-tool.js';
  */
 export const invoiceListTool = {
     name: 'invoice_list',
-    description: `List invoices from FreshBooks.
-
-WHEN TO USE:
-- User asks to see invoices, bills sent to clients, or outstanding payments
-- User wants to review invoices for a specific client
-- User needs to find invoices by status (draft, sent, paid, overdue)
-- User asks "show my invoices", "what invoices are unpaid", "list client invoices"
-
-REQUIRED:
-- accountId: FreshBooks account ID (get from auth_status if not specified)
-
-OPTIONAL FILTERS:
-- customerId: Filter by specific customer/client
-- status: Filter by invoice status (draft, sent, viewed, partial, paid, overdue, etc.)
-- paymentStatus: Filter by payment status (unpaid, partial, paid)
-- dateMin: Show invoices created after this date (YYYY-MM-DD)
-- dateMax: Show invoices created before this date (YYYY-MM-DD)
-- updatedSince: Show invoices updated since this time (ISO 8601)
-
-SORTING:
-- sortBy: Field to sort by (create_date, due_date, updated, amount, outstanding)
-- sortOrder: Sort direction (asc or desc, default: desc for newest first)
-
-INCLUDES:
-- include: Related data to fetch (lines, presentation)
-  - lines: Invoice line items with quantities and amounts
-  - presentation: Invoice styling/presentation settings
-
-PAGINATION:
-- page: Page number (default: 1)
-- perPage: Results per page (default: 30, max: 100)
-
-RETURNS:
-Array of invoices with amount, status, payment status, and line items.
-Plus pagination metadata (page, pages, total)
-
-EXAMPLES:
-- "Show all unpaid invoices"
-- "List invoices for customer 12345"
-- "Show me overdue invoices sorted by amount"
+    description: `List invoices from FreshBooks.
+
+WHEN TO USE:
+- User asks to see invoices, bills sent to clients, or outstanding payments
+- User wants to review invoices for a specific client
+- User needs to find invoices by status (draft, sent, paid, overdue)
+- User asks "show my invoices", "what invoices are unpaid", "list client invoices"
+
+REQUIRED:
+- accountId: FreshBooks account ID (get from auth_status if not specified)
+
+OPTIONAL FILTERS:
+- customerId: Filter by specific customer/client
+- status: Filter by invoice status (draft, sent, viewed, partial, paid, overdue, etc.)
+- paymentStatus: Filter by payment status (unpaid, partial, paid)
+- dateMin: Show invoices created after this date (YYYY-MM-DD)
+- dateMax: Show invoices created before this date (YYYY-MM-DD)
+- updatedSince: Show invoices updated since this time (ISO 8601)
+
+SORTING:
+- sortBy: Field to sort by (create_date, due_date, updated, amount, outstanding)
+- sortOrder: Sort direction (asc or desc, default: desc for newest first)
+
+INCLUDES:
+- include: Related data to fetch (lines, presentation)
+  - lines: Invoice line items with quantities and amounts
+  - presentation: Invoice styling/presentation settings
+
+PAGINATION:
+- page: Page number (default: 1)
+- perPage: Results per page (default: 30, max: 100)
+
+RETURNS:
+Array of invoices with amount, status, payment status, and line items.
+Plus pagination metadata (page, pages, total)
+
+EXAMPLES:
+- "Show all unpaid invoices"
+- "List invoices for customer 12345"
+- "Show me overdue invoices sorted by amount"
 - "Get invoices with line items included"`,
     inputSchema: InvoiceListInputSchema,
     outputSchema: InvoiceListOutputSchema,

package/dist/tools/project/project-create.js

@@ -10,40 +10,40 @@ import { ErrorHandler } from "../../errors/error-handler.js";
  */
 export const projectCreateTool = {
     name: "project_create",
-    description: `Create a new project in FreshBooks.
-
-WHEN TO USE:
-- User wants to create a new project
-- User says "start a project", "create project", "new project"
-- Setting up work tracking for a new client or initiative
-
-REQUIRED INFO:
-- title: Project name (user must provide)
-- accountId: FreshBooks account (get from context)
-
-OPTIONAL BUT HELPFUL:
-- clientId: Associate with a client for billing
-- description: What the project is about
-- dueDate: When project should be completed (ISO 8601)
-- billingMethod: How to bill (project_rate, service_rate, flat_rate, team_member_rate)
-- projectType: fixed_price or hourly_rate
-- rate: Hourly rate if hourly_rate type
-- fixedPrice: Total price if fixed_price type
-- budget: Project budget amount
-- internal: Set to true for non-billable internal work
-
-BILLING METHODS:
-- project_rate: Bill at project-level hourly rate
-- service_rate: Bill based on service assigned to time entries
-- flat_rate: Fixed price project
-- team_member_rate: Bill at individual team member rates
-
-EXAMPLE PROMPTS:
-- "Create a new project called Website Redesign"
-- "Start a project for client ABC123: Mobile App Development"
-- "New internal project for training, not billable"
-
-RETURNS:
+    description: `Create a new project in FreshBooks.
+
+WHEN TO USE:
+- User wants to create a new project
+- User says "start a project", "create project", "new project"
+- Setting up work tracking for a new client or initiative
+
+REQUIRED INFO:
+- title: Project name (user must provide)
+- accountId: FreshBooks account (get from context)
+
+OPTIONAL BUT HELPFUL:
+- clientId: Associate with a client for billing
+- description: What the project is about
+- dueDate: When project should be completed (ISO 8601)
+- billingMethod: How to bill (project_rate, service_rate, flat_rate, team_member_rate)
+- projectType: fixed_price or hourly_rate
+- rate: Hourly rate if hourly_rate type
+- fixedPrice: Total price if fixed_price type
+- budget: Project budget amount
+- internal: Set to true for non-billable internal work
+
+BILLING METHODS:
+- project_rate: Bill at project-level hourly rate
+- service_rate: Bill based on service assigned to time entries
+- flat_rate: Fixed price project
+- team_member_rate: Bill at individual team member rates
+
+EXAMPLE PROMPTS:
+- "Create a new project called Website Redesign"
+- "Start a project for client ABC123: Mobile App Development"
+- "New internal project for training, not billable"
+
+RETURNS:
 Created project with ID and all configured settings. Use this ID for time tracking.`,
     inputSchema: ProjectCreateInputSchema,
     outputSchema: ProjectSingleOutputSchema,

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

@@ -11,44 +11,44 @@ import { ErrorHandler } from "../../errors/error-handler.js";
  */
 export const projectDeleteTool = {
     name: "project_delete",
-    description: `Delete a project from FreshBooks.
-
-WARNING: This permanently deletes the project and cannot be undone.
-
-WHEN TO USE:
-- User wants to permanently remove a project
-- User says "delete project", "remove project"
-- Cleaning up test or duplicate projects
-
-REQUIRED INFO:
-- projectId: Which project to delete (numeric)
-- accountId: FreshBooks account (get from context)
-
-IMPORTANT WARNINGS:
-- Deletion is permanent and cannot be undone
-- Consider marking project inactive (active=false) instead for soft-delete
-- Time entries associated with project may be affected
-- Historical billing data will lose project reference
-
-SAFER ALTERNATIVES:
-- Use project_update with active=false to deactivate
-- Use project_update with complete=true to mark done
-- These preserve data and can be reversed
-
-WHEN TO ACTUALLY DELETE:
-- Test projects that were created by mistake
-- Duplicate projects
-- Projects with no time entries or billing history
-
-EXAMPLE PROMPTS:
-- "Delete project 12345" (use cautiously)
-- "Remove the test project I just created"
-
-BEFORE DELETING:
-Recommend asking user "Are you sure?" and suggesting deactivation as alternative.
-You might want to check if project has logged time first using project_single.
-
-RETURNS:
+    description: `Delete a project from FreshBooks.
+
+WARNING: This permanently deletes the project and cannot be undone.
+
+WHEN TO USE:
+- User wants to permanently remove a project
+- User says "delete project", "remove project"
+- Cleaning up test or duplicate projects
+
+REQUIRED INFO:
+- projectId: Which project to delete (numeric)
+- accountId: FreshBooks account (get from context)
+
+IMPORTANT WARNINGS:
+- Deletion is permanent and cannot be undone
+- Consider marking project inactive (active=false) instead for soft-delete
+- Time entries associated with project may be affected
+- Historical billing data will lose project reference
+
+SAFER ALTERNATIVES:
+- Use project_update with active=false to deactivate
+- Use project_update with complete=true to mark done
+- These preserve data and can be reversed
+
+WHEN TO ACTUALLY DELETE:
+- Test projects that were created by mistake
+- Duplicate projects
+- Projects with no time entries or billing history
+
+EXAMPLE PROMPTS:
+- "Delete project 12345" (use cautiously)
+- "Remove the test project I just created"
+
+BEFORE DELETING:
+Recommend asking user "Are you sure?" and suggesting deactivation as alternative.
+You might want to check if project has logged time first using project_single.
+
+RETURNS:
 Success confirmation with the deleted project ID.`,
     inputSchema: ProjectDeleteInputSchema,
     outputSchema: ProjectDeleteOutputSchema,