FreshBooks

FreshBooks MCP Server for Cloudflare Workers

Available Tools

57 tools available in the FreshBooks MCP server. Each tool can be called by AI assistants to perform specific actions.

freshbooks_delete_invoice

Delete (archive) an invoice from FreshBooks.

Args:

id: Invoice ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Invoice ID to delete"
    }
  }
}

freshbooks_convert_estimate_to_invoice

Convert an accepted estimate to an invoice.

Args:

id: Estimate ID to convert

Returns: The created invoice record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Estimate ID to convert"
    }
  }
}

freshbooks_delete_estimate

Delete (archive) an estimate from FreshBooks.

Args:

id: Estimate ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Estimate ID to delete"
    }
  }
}

freshbooks_send_estimate

Send an estimate via email.

Args:

id: Estimate ID to send
recipients: Array of email addresses

Returns: Confirmation of sending.

{
  "type": "object",
  "required": [
    "id",
    "recipients"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Estimate ID to send"
    },
    "recipients": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email recipients"
    }
  }
}

freshbooks_list_clients

List clients from FreshBooks with pagination.

Returns a paginated list of clients.

Args:

page: Page number (1-based, default: 1)
perPage: Number of clients per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Client[], count, total, page, pages, hasMore } Markdown format: Formatted table of clients

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_client

Get a single client by ID.

Args:

id: The client ID
format: Response format ('json' or 'markdown')

Returns: The client record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Client ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_create_client

Create a new client in FreshBooks.

Args:

organization: Business/organization name
firstName: First name
lastName: Last name
email: Email address
workPhone: Work phone number
homePhone: Home phone number
mobilePhone: Mobile phone number
billingStreet: Billing street address
billingCity: Billing city
billingProvince: Billing province/state
billingPostalCode: Billing postal code
billingCountry: Billing country
currencyCode: Currency code (e.g., 'USD', 'CAD')
language: Language code
note: Notes about the client

Returns: The created client record.

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string",
      "description": "Notes about the client"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "vatName": {
      "type": "string",
      "description": "VAT name"
    },
    "language": {
      "type": "string",
      "description": "Language code"
    },
    "lastName": {
      "type": "string",
      "description": "Last name"
    },
    "firstName": {
      "type": "string",
      "description": "First name"
    },
    "homePhone": {
      "type": "string",
      "description": "Home phone number"
    },
    "vatNumber": {
      "type": "string",
      "description": "VAT number"
    },
    "workPhone": {
      "type": "string",
      "description": "Work phone number"
    },
    "billingCity": {
      "type": "string",
      "description": "Billing city"
    },
    "mobilePhone": {
      "type": "string",
      "description": "Mobile phone number"
    },
    "currencyCode": {
      "type": "string",
      "description": "Currency code (e.g., USD, CAD)"
    },
    "organization": {
      "type": "string",
      "description": "Business/organization name"
    },
    "shippingCity": {
      "type": "string",
      "description": "Shipping city"
    },
    "billingStreet": {
      "type": "string",
      "description": "Billing street address"
    },
    "billingCountry": {
      "type": "string",
      "description": "Billing country"
    },
    "billingStreet2": {
      "type": "string",
      "description": "Billing street address line 2"
    },
    "shippingStreet": {
      "type": "string",
      "description": "Shipping street address"
    },
    "billingProvince": {
      "type": "string",
      "description": "Billing province/state"
    },
    "shippingCountry": {
      "type": "string",
      "description": "Shipping country"
    },
    "shippingProvince": {
      "type": "string",
      "description": "Shipping province/state"
    },
    "billingPostalCode": {
      "type": "string",
      "description": "Billing postal code"
    },
    "shippingPostalCode": {
      "type": "string",
      "description": "Shipping postal code"
    }
  }
}

freshbooks_update_client

Update an existing client.

Args:

id: Client ID to update
(same fields as create)

Returns: The updated client record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Client ID to update"
    },
    "note": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "vatName": {
      "type": "string"
    },
    "language": {
      "type": "string"
    },
    "lastName": {
      "type": "string"
    },
    "firstName": {
      "type": "string"
    },
    "homePhone": {
      "type": "string"
    },
    "vatNumber": {
      "type": "string"
    },
    "workPhone": {
      "type": "string"
    },
    "billingCity": {
      "type": "string"
    },
    "mobilePhone": {
      "type": "string"
    },
    "currencyCode": {
      "type": "string"
    },
    "organization": {
      "type": "string"
    },
    "shippingCity": {
      "type": "string"
    },
    "billingStreet": {
      "type": "string"
    },
    "billingCountry": {
      "type": "string"
    },
    "billingStreet2": {
      "type": "string"
    },
    "shippingStreet": {
      "type": "string"
    },
    "billingProvince": {
      "type": "string"
    },
    "shippingCountry": {
      "type": "string"
    },
    "shippingProvince": {
      "type": "string"
    },
    "billingPostalCode": {
      "type": "string"
    },
    "shippingPostalCode": {
      "type": "string"
    }
  }
}

freshbooks_delete_client

Delete (archive) a client from FreshBooks.

Args:

id: Client ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Client ID to delete"
    }
  }
}

freshbooks_list_estimates

List estimates from FreshBooks with pagination.

Returns a paginated list of estimates.

Args:

page: Page number (1-based, default: 1)
perPage: Number of estimates per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Estimate[], count, total, page, pages, hasMore } Markdown format: Formatted table of estimates

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_estimate

Get a single estimate by ID.

Args:

id: The estimate ID
format: Response format ('json' or 'markdown')

Returns: The estimate record with all available fields including line items.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Estimate ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_create_estimate

Create a new estimate in FreshBooks.

Args:

clientId: Client ID (required)
createDate: Estimate date in YYYY-MM-DD format (required)
lines: Array of line items (required)
currencyCode: Currency code (e.g., 'USD', 'CAD')
language: Language code
poNumber: Purchase order number
discountValue: Discount percentage
notes: Notes to appear on estimate
terms: Terms and conditions
street: Client street address override
city: Client city override
province: Client province override
postalCode: Client postal code override
country: Client country override

Returns: The created estimate record.

{
  "type": "object",
  "required": [
    "clientId",
    "createDate",
    "lines"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "Client city override"
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Line items"
    },
    "notes": {
      "type": "string",
      "description": "Estimate notes"
    },
    "terms": {
      "type": "string",
      "description": "Terms and conditions"
    },
    "street": {
      "type": "string",
      "description": "Client street address override"
    },
    "country": {
      "type": "string",
      "description": "Client country override"
    },
    "clientId": {
      "type": "integer",
      "description": "Client ID (required)"
    },
    "language": {
      "type": "string",
      "description": "Language code"
    },
    "poNumber": {
      "type": "string",
      "description": "Purchase order number"
    },
    "province": {
      "type": "string",
      "description": "Client province override"
    },
    "createDate": {
      "type": "string",
      "description": "Estimate date (YYYY-MM-DD)"
    },
    "postalCode": {
      "type": "string",
      "description": "Client postal code override"
    },
    "currencyCode": {
      "type": "string",
      "description": "Currency code"
    },
    "discountValue": {
      "type": "number",
      "description": "Discount percentage"
    }
  }
}

freshbooks_update_estimate

Update an existing estimate.

Args:

id: Estimate ID to update
(same fields as create, plus action fields)
actionMarkAsSent: Mark estimate as sent
actionEmail: Send estimate via email
emailRecipients: Array of email addresses to send to

Returns: The updated estimate record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Estimate ID to update"
    },
    "city": {
      "type": "string"
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "type": "string"
    },
    "terms": {
      "type": "string"
    },
    "street": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "clientId": {
      "type": "integer"
    },
    "language": {
      "type": "string"
    },
    "poNumber": {
      "type": "string"
    },
    "province": {
      "type": "string"
    },
    "createDate": {
      "type": "string"
    },
    "postalCode": {
      "type": "string"
    },
    "actionEmail": {
      "type": "boolean",
      "description": "Send via email"
    },
    "currencyCode": {
      "type": "string"
    },
    "discountValue": {
      "type": "number"
    },
    "emailRecipients": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email recipients"
    },
    "actionMarkAsSent": {
      "type": "boolean",
      "description": "Mark as sent"
    }
  }
}

freshbooks_list_expense_categories

List expense categories from FreshBooks with pagination.

Returns a paginated list of expense categories used to classify expenses.

Args:

page: Page number (1-based, default: 1)
perPage: Number of categories per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: ExpenseCategory[], count, total, page, pages, hasMore } Markdown format: Formatted table of expense categories

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_expense_category

Get a single expense category by ID.

Args:

id: The expense category ID
format: Response format ('json' or 'markdown')

Returns: The expense category record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Expense category ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_list_expenses

List expenses from FreshBooks with pagination.

Returns a paginated list of expenses.

Args:

page: Page number (1-based, default: 1)
perPage: Number of expenses per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Expense[], count, total, page, pages, hasMore } Markdown format: Formatted table of expenses

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_expense

Get a single expense by ID.

Args:

id: The expense ID
format: Response format ('json' or 'markdown')

Returns: The expense record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Expense ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_update_invoice

Update an existing invoice.

Args:

id: Invoice ID to update
(same fields as create, plus action fields)
actionMarkAsSent: Mark invoice as sent
actionEmail: Send invoice via email
emailRecipients: Array of email addresses to send to
emailSubject: Custom email subject
emailBody: Custom email body

Returns: The updated invoice record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Invoice ID to update"
    },
    "city": {
      "type": "string"
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "type": "string"
    },
    "terms": {
      "type": "string"
    },
    "street": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "clientId": {
      "type": "integer"
    },
    "language": {
      "type": "string"
    },
    "poNumber": {
      "type": "string"
    },
    "province": {
      "type": "string"
    },
    "emailBody": {
      "type": "string",
      "description": "Email body"
    },
    "createDate": {
      "type": "string"
    },
    "postalCode": {
      "type": "string"
    },
    "actionEmail": {
      "type": "boolean",
      "description": "Send via email"
    },
    "currencyCode": {
      "type": "string"
    },
    "emailSubject": {
      "type": "string",
      "description": "Email subject"
    },
    "depositAmount": {
      "type": "number"
    },
    "discountValue": {
      "type": "number"
    },
    "dueOffsetDays": {
      "type": "integer"
    },
    "emailRecipients": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email recipients"
    },
    "actionMarkAsSent": {
      "type": "boolean",
      "description": "Mark as sent"
    },
    "depositPercentage": {
      "type": "number"
    },
    "discountDescription": {
      "type": "string"
    }
  }
}

freshbooks_create_expense

Create a new expense in FreshBooks.

Args:

amount: Amount object with 'amount' (string) and 'code' (currency)
date: Expense date in YYYY-MM-DD format (required)
categoryId: Expense category ID (required)
staffId: Staff member ID (required)
vendor: Vendor name
projectId: Associated project ID
clientId: Associated client ID
notes: Notes about the expense
taxName1: First tax name
taxAmount1: First tax amount
taxPercent1: First tax percentage
taxName2: Second tax name
taxAmount2: Second tax amount
taxPercent2: Second tax percentage
markupPercent: Markup percentage for billing

Returns: The created expense record.

{
  "type": "object",
  "required": [
    "date",
    "categoryId",
    "staffId"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Expense date (YYYY-MM-DD)"
    },
    "notes": {
      "type": "string",
      "description": "Notes"
    },
    "vendor": {
      "type": "string",
      "description": "Vendor name"
    },
    "staffId": {
      "type": "integer",
      "description": "Staff member ID"
    },
    "clientId": {
      "type": "integer",
      "description": "Client ID"
    },
    "taxName1": {
      "type": "string",
      "description": "First tax name"
    },
    "taxName2": {
      "type": "string",
      "description": "Second tax name"
    },
    "projectId": {
      "type": "integer",
      "description": "Project ID"
    },
    "categoryId": {
      "type": "integer",
      "description": "Expense category ID"
    },
    "taxAmount1": {
      "type": "number",
      "description": "First tax amount"
    },
    "taxAmount2": {
      "type": "number",
      "description": "Second tax amount"
    },
    "taxPercent1": {
      "type": "number",
      "description": "First tax percentage"
    },
    "taxPercent2": {
      "type": "number",
      "description": "Second tax percentage"
    },
    "markupPercent": {
      "type": "number",
      "description": "Markup percentage"
    }
  }
}

freshbooks_update_expense

Update an existing expense.

Args:

id: Expense ID to update
(same fields as create)

Returns: The updated expense record.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Expense ID to update"
    },
    "date": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "vendor": {
      "type": "string"
    },
    "staffId": {
      "type": "integer"
    },
    "clientId": {
      "type": "integer"
    },
    "taxName1": {
      "type": "string"
    },
    "taxName2": {
      "type": "string"
    },
    "projectId": {
      "type": "integer"
    },
    "categoryId": {
      "type": "integer"
    },
    "taxAmount1": {
      "type": "number"
    },
    "taxAmount2": {
      "type": "number"
    },
    "taxPercent1": {
      "type": "number"
    },
    "taxPercent2": {
      "type": "number"
    },
    "markupPercent": {
      "type": "number"
    }
  }
}

freshbooks_delete_expense

Delete (archive) an expense from FreshBooks.

Args:

id: Expense ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Expense ID to delete"
    }
  }
}

freshbooks_list_invoices

List invoices from FreshBooks with pagination.

Returns a paginated list of invoices.

Args:

page: Page number (1-based, default: 1)
perPage: Number of invoices per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Invoice[], count, total, page, pages, hasMore } Markdown format: Formatted table of invoices

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_invoice

Get a single invoice by ID.

Args:

id: The invoice ID
format: Response format ('json' or 'markdown')

Returns: The invoice record with all available fields including line items.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Invoice ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_get_payment

Get a single payment by ID.

Args:

id: The payment ID
format: Response format ('json' or 'markdown')

Returns: The payment record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Payment ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_create_payment

Record a new payment in FreshBooks.

Args:

invoiceId: Invoice ID the payment is for (required)
amount: Amount object with 'amount' (string) and 'code' (currency) (required)
date: Payment date in YYYY-MM-DD format (required)
type: Payment type (e.g., 'Check', 'Credit', 'Cash', 'Bank Transfer', 'PayPal')
note: Notes about the payment

Returns: The created payment record.

{
  "type": "object",
  "required": [
    "invoiceId",
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Payment date (YYYY-MM-DD)"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    },
    "type": {
      "type": "string",
      "description": "Payment type"
    },
    "invoiceId": {
      "type": "integer",
      "description": "Invoice ID"
    }
  }
}

freshbooks_create_invoice

Create a new invoice in FreshBooks.

Args:

clientId: Client ID (required)
createDate: Invoice date in YYYY-MM-DD format (required)
lines: Array of line items (required)
dueOffsetDays: Number of days until due
currencyCode: Currency code (e.g., 'USD', 'CAD')
language: Language code
poNumber: Purchase order number
discountValue: Discount percentage
discountDescription: Description of discount
notes: Notes to appear on invoice
terms: Payment terms
depositAmount: Deposit amount
depositPercentage: Deposit percentage
street: Client street address override
city: Client city override
province: Client province override
postalCode: Client postal code override
country: Client country override

Returns: The created invoice record.

{
  "type": "object",
  "required": [
    "clientId",
    "createDate",
    "lines"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "Client city override"
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Line items"
    },
    "notes": {
      "type": "string",
      "description": "Invoice notes"
    },
    "terms": {
      "type": "string",
      "description": "Payment terms"
    },
    "street": {
      "type": "string",
      "description": "Client street address override"
    },
    "country": {
      "type": "string",
      "description": "Client country override"
    },
    "clientId": {
      "type": "integer",
      "description": "Client ID (required)"
    },
    "language": {
      "type": "string",
      "description": "Language code"
    },
    "poNumber": {
      "type": "string",
      "description": "Purchase order number"
    },
    "province": {
      "type": "string",
      "description": "Client province override"
    },
    "createDate": {
      "type": "string",
      "description": "Invoice date (YYYY-MM-DD)"
    },
    "estimateId": {
      "type": "integer",
      "description": "Associated estimate ID"
    },
    "postalCode": {
      "type": "string",
      "description": "Client postal code override"
    },
    "currencyCode": {
      "type": "string",
      "description": "Currency code"
    },
    "depositAmount": {
      "type": "number",
      "description": "Deposit amount"
    },
    "discountValue": {
      "type": "number",
      "description": "Discount percentage"
    },
    "dueOffsetDays": {
      "type": "integer",
      "description": "Days until due"
    },
    "depositPercentage": {
      "type": "number",
      "description": "Deposit percentage"
    },
    "discountDescription": {
      "type": "string",
      "description": "Discount description"
    }
  }
}

freshbooks_send_invoice

Send an invoice via email.

Args:

id: Invoice ID to send
recipients: Array of email addresses
subject: Email subject (optional)
body: Email body (optional)

Returns: Confirmation of sending.

{
  "type": "object",
  "required": [
    "id",
    "recipients"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Invoice ID to send"
    },
    "body": {
      "type": "string",
      "description": "Email body"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    },
    "recipients": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email recipients"
    }
  }
}

freshbooks_list_items

List items/products from FreshBooks with pagination.

Returns a paginated list of items that can be used on invoices.

Args:

page: Page number (1-based, default: 1)
perPage: Number of items per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Item[], count, total, page, pages, hasMore } Markdown format: Formatted table of items

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_item

Get a single item by ID.

Args:

id: The item ID
format: Response format ('json' or 'markdown')

Returns: The item record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Item ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_create_item

Create a new item/product in FreshBooks.

Args:

name: Item name (required)
description: Item description
sku: Stock keeping unit code
qty: Default quantity
unitCost: Unit cost object with 'amount' and 'code' (currency)
inventory: Inventory count
tax1: First tax ID
tax2: Second tax ID

Returns: The created item record.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "qty": {
      "type": "number",
      "description": "Default quantity"
    },
    "sku": {
      "type": "string",
      "description": "SKU code"
    },
    "name": {
      "type": "string",
      "description": "Item name"
    },
    "tax1": {
      "type": "number",
      "description": "First tax ID"
    },
    "tax2": {
      "type": "number",
      "description": "Second tax ID"
    },
    "inventory": {
      "type": "number",
      "description": "Inventory count"
    },
    "description": {
      "type": "string",
      "description": "Item description"
    }
  }
}

freshbooks_update_item

Update an existing item.

Args:

id: Item ID to update
name: New name
description: New description
sku: New SKU
qty: New default quantity
unitCost: New unit cost
inventory: New inventory count
tax1: New first tax ID
tax2: New second tax ID

Returns: The updated item record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Item ID to update"
    },
    "qty": {
      "type": "number"
    },
    "sku": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "tax1": {
      "type": "number"
    },
    "tax2": {
      "type": "number"
    },
    "inventory": {
      "type": "number"
    },
    "description": {
      "type": "string"
    }
  }
}

freshbooks_delete_item

Delete (archive) an item from FreshBooks.

Args:

id: Item ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Item ID to delete"
    }
  }
}

freshbooks_list_payments

List payments from FreshBooks with pagination.

Returns a paginated list of payments.

Args:

page: Page number (1-based, default: 1)
perPage: Number of payments per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Payment[], count, total, page, pages, hasMore } Markdown format: Formatted table of payments

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_update_payment

Update an existing payment.

Args:

id: Payment ID to update
amount: New amount object
date: New payment date
type: New payment type
note: New notes

Returns: The updated payment record.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Payment ID to update"
    },
    "date": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  }
}

freshbooks_delete_payment

Delete a payment from FreshBooks.

Args:

id: Payment ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Payment ID to delete"
    }
  }
}

freshbooks_list_projects

List projects from FreshBooks with pagination.

Returns a paginated list of projects.

Args:

page: Page number (1-based, default: 1)
perPage: Number of projects per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Project[], count, total, page, pages, hasMore } Markdown format: Formatted table of projects

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_project

Get a single project by ID.

Args:

id: The project ID
format: Response format ('json' or 'markdown')

Returns: The project record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Project ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_create_project

Create a new project in FreshBooks.

Args:

title: Project title (required)
description: Project description
clientId: Associated client ID
dueDate: Due date in YYYY-MM-DD format
budget: Budget amount
rate: Hourly rate
projectType: Type of project
fixedPrice: Fixed price for the project
billingMethod: Billing method
internal: Whether this is an internal project

Returns: The created project record.

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "rate": {
      "type": "number",
      "description": "Hourly rate"
    },
    "title": {
      "type": "string",
      "description": "Project title"
    },
    "budget": {
      "type": "number",
      "description": "Budget amount"
    },
    "dueDate": {
      "type": "string",
      "description": "Due date (YYYY-MM-DD)"
    },
    "clientId": {
      "type": "integer",
      "description": "Client ID"
    },
    "internal": {
      "type": "boolean",
      "description": "Internal project"
    },
    "fixedPrice": {
      "type": "number",
      "description": "Fixed price"
    },
    "description": {
      "type": "string",
      "description": "Project description"
    },
    "projectType": {
      "type": "string",
      "description": "Project type"
    },
    "billingMethod": {
      "type": "string",
      "description": "Billing method"
    }
  }
}

freshbooks_update_project

Update an existing project.

Args:

id: Project ID to update
title: New title
description: New description
clientId: New client ID
dueDate: New due date
budget: New budget
rate: New hourly rate
projectType: New project type
fixedPrice: New fixed price
billingMethod: New billing method
internal: Update internal status
complete: Mark project as complete

Returns: The updated project record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Project ID to update"
    },
    "rate": {
      "type": "number"
    },
    "title": {
      "type": "string"
    },
    "budget": {
      "type": "number"
    },
    "dueDate": {
      "type": "string"
    },
    "clientId": {
      "type": "integer"
    },
    "complete": {
      "type": "boolean",
      "description": "Mark as complete"
    },
    "internal": {
      "type": "boolean"
    },
    "fixedPrice": {
      "type": "number"
    },
    "description": {
      "type": "string"
    },
    "projectType": {
      "type": "string"
    },
    "billingMethod": {
      "type": "string"
    }
  }
}

freshbooks_delete_project

Delete a project from FreshBooks.

Args:

id: Project ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Project ID to delete"
    }
  }
}

freshbooks_list_services

List services/task types from FreshBooks with pagination.

Services are used to categorize time entries (e.g., "Development", "Design", "Meetings").

Args:

page: Page number (1-based, default: 1)
perPage: Number of services per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Service[], count, total, page, pages, hasMore } Markdown format: Formatted table of services

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_service

Get a single service by ID.

Args:

id: The service ID
format: Response format ('json' or 'markdown')

Returns: The service record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Service ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_create_service

Create a new service/task type in FreshBooks.

Args:

name: Service name (required)
billable: Whether time tracked with this service is billable by default
projectDefault: Whether this service is added to new projects by default

Returns: The created service record.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Service name"
    },
    "billable": {
      "type": "boolean",
      "description": "Billable by default"
    },
    "projectDefault": {
      "type": "boolean",
      "description": "Add to new projects by default"
    }
  }
}

freshbooks_list_staff

List staff members from FreshBooks with pagination.

Returns a paginated list of staff/team members in the account.

Args:

page: Page number (1-based, default: 1)
perPage: Number of staff per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Staff[], count, total, page, pages, hasMore } Markdown format: Formatted table of staff members

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_staff

Get a single staff member by ID.

Args:

id: The staff member ID
format: Response format ('json' or 'markdown')

Returns: The staff record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Staff member ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_get_current_user

Get the current authenticated user's information.

Returns: The current user's profile including identity and business memberships.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshbooks_test_connection

Test the connection to FreshBooks API.

Verifies that the access token and account ID are valid.

Returns: Connection status and current user information if successful.

{
  "type": "object",
  "properties": {}
}

freshbooks_list_taxes

List taxes from FreshBooks with pagination.

Returns a paginated list of tax rates that can be applied to invoices.

Args:

page: Page number (1-based, default: 1)
perPage: Number of taxes per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: Tax[], count, total, page, pages, hasMore } Markdown format: Formatted table of taxes

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_tax

Get a single tax by ID.

Args:

id: The tax ID
format: Response format ('json' or 'markdown')

Returns: The tax record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Tax ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_create_tax

Create a new tax rate in FreshBooks.

Args:

name: Tax name (required, e.g., "GST", "VAT")
amount: Tax percentage (required, e.g., 5 for 5%)
number: Tax registration number
compound: Whether this tax is compounded on other taxes

Returns: The created tax record.

{
  "type": "object",
  "required": [
    "name",
    "amount"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Tax name"
    },
    "amount": {
      "type": "number",
      "description": "Tax percentage"
    },
    "number": {
      "type": "string",
      "description": "Tax registration number"
    },
    "compound": {
      "type": "boolean",
      "description": "Compound tax"
    }
  }
}

freshbooks_update_tax

Update an existing tax rate.

Args:

id: Tax ID to update
name: New tax name
amount: New tax percentage
number: New tax registration number
compound: Update compound setting

Returns: The updated tax record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Tax ID to update"
    },
    "name": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "number": {
      "type": "string"
    },
    "compound": {
      "type": "boolean"
    }
  }
}

freshbooks_delete_tax

Delete a tax rate from FreshBooks.

Args:

id: Tax ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Tax ID to delete"
    }
  }
}

freshbooks_list_time_entries

List time entries from FreshBooks with pagination.

Returns a paginated list of time entries.

Args:

page: Page number (1-based, default: 1)
perPage: Number of entries per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: JSON format: { items: TimeEntry[], count, total, page, pages, hasMore } Markdown format: Formatted table of time entries

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

freshbooks_get_time_entry

Get a single time entry by ID.

Args:

id: The time entry ID
format: Response format ('json' or 'markdown')

Returns: The time entry record with all available fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Time entry ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshbooks_create_time_entry

Create a new time entry in FreshBooks.

Args:

isLogged: Whether the time is logged (true) or a timer (false) (required)
duration: Duration in seconds (required)
startedAt: Start time in ISO format (required)
note: Description of work done
clientId: Associated client ID
projectId: Associated project ID
serviceId: Service/task type ID
internal: Whether this is internal time
billable: Whether this time is billable

Returns: The created time entry record.

{
  "type": "object",
  "required": [
    "isLogged",
    "duration",
    "startedAt"
  ],
  "properties": {
    "note": {
      "type": "string",
      "description": "Description of work"
    },
    "billable": {
      "type": "boolean",
      "description": "Billable time"
    },
    "clientId": {
      "type": "integer",
      "description": "Client ID"
    },
    "duration": {
      "type": "integer",
      "description": "Duration in seconds"
    },
    "internal": {
      "type": "boolean",
      "description": "Internal time"
    },
    "isLogged": {
      "type": "boolean",
      "description": "Whether time is logged (true) or timer (false)"
    },
    "projectId": {
      "type": "integer",
      "description": "Project ID"
    },
    "serviceId": {
      "type": "integer",
      "description": "Service ID"
    },
    "startedAt": {
      "type": "string",
      "description": "Start time (ISO format)"
    }
  }
}

freshbooks_update_time_entry

Update an existing time entry.

Args:

id: Time entry ID to update
isLogged: Whether time is logged
duration: New duration in seconds
startedAt: New start time
note: New description
clientId: New client ID
projectId: New project ID
serviceId: New service ID
internal: Update internal status
billable: Update billable status

Returns: The updated time entry record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Time entry ID to update"
    },
    "note": {
      "type": "string"
    },
    "billable": {
      "type": "boolean"
    },
    "clientId": {
      "type": "integer"
    },
    "duration": {
      "type": "integer"
    },
    "internal": {
      "type": "boolean"
    },
    "isLogged": {
      "type": "boolean"
    },
    "projectId": {
      "type": "integer"
    },
    "serviceId": {
      "type": "integer"
    },
    "startedAt": {
      "type": "string"
    }
  }
}

freshbooks_delete_time_entry

Delete a time entry from FreshBooks.

Args:

id: Time entry ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Time entry ID to delete"
    }
  }
}