archive_project
ChatGPTArchive (soft-delete) a project — sets deletedAt; it drops out of default lists but tracked time + invoices stay intact for history. This is NOT the same as status=ARCHIVED (use update_project for that). DESTRUCTIVE — requires confirm: true (only pass it after the user explicitly confirmed). Requires a write-scoped Manager+ token.
archive_task
ChatGPTArchive (soft-delete) a task — tracked time stays intact for invoicing/history. DESTRUCTIVE: requires confirm: true (only pass it after the user explicitly confirmed) and a write-scoped Manager+ token (a Member can edit an assigned task but cannot archive one).
create_client
ChatGPTCreate a new client. Requires a write-scoped Manager+ token (Member tokens get forbidden_scope). Returns the created client with its ID. Only name is required; everything else is optional. Money fields accept a number or a decimal-string.
create_expense
ChatGPTRecord a new expense against a client (and optionally a project under that client). Requires a write-scoped Manager+ token. category is one of: TRAVEL, MEALS, SOFTWARE, EQUIPMENT, CONTRACTORS, OTHER (defaults to OTHER). description is REQUIRED. amount accepts a number or decimal-string (> 0, up to 2 dp). Currency is NOT accepted — the server snapshots the client's currency.
create_project
ChatGPTCreate a new project under a client. Requires a write-scoped Manager+ token. Server-enforced rules: budgetAmount and budgetHours are mutually exclusive; FIXED projects must set fixedFeeAmount and may only use a budgetHours effort cap; dueDate must be ≥ startDate. hourlyRate is required only for HOURLY projects unless the owning client has a defaultRate to inherit. Project rates, fees, and budgets accept a number (30) or decimal-string ("30.00"), with at most 2 decimal places and the documented Decimal-column maximum.
create_task
ChatGPTCreate a new task under a project in the selected workspace; this create operation does not send assignment notifications. Requires a write-scoped token. Manager+ can create + assign current workspace members; a Member may only create tasks assigned to themselves (assigning a teammate → forbidden_scope). billable is a real JSON boolean (true/false); FIXED and NON_BILLABLE projects always store false. estimatedHours accepts a number or decimal-string. endDate must be ≥ startDate.
create_time_entry
ChatGPTCreate a new manual time entry in the selected workspace. Updates project budget totals and may add in-app budget alerts; does not create or send invoices, initiate payments, or start a timer. Send `durationSeconds` (integer) — that's the canonical shape. For 8 hours pass durationSeconds: 28800; for 90 minutes pass 5400. (Legacy alternative: duration as a string like "1h30m", "1:30", "90m", or "1.5h" — the form path. If you pass both, durationSeconds wins.) To record WHEN the work happened, send startTime + endTime as "HH:mm" instead of a duration — the duration is then derived from them. Both or neither. billable is a real boolean (true/false); FIXED and NON_BILLABLE projects always store false, even when true is requested. Owner/Admin can pass userId to log on behalf of a teammate; Manager/Member tokens may only log for themselves. Refuses entries longer than 24 hours.
delete_client
ChatGPTPermanently delete a client. DESTRUCTIVE and irreversible — requires confirm: true (only pass it after the user explicitly confirmed). Refuses (409 conflict) if the client still has projects, invoices, or time entries — archive those first. Requires a write-scoped Manager+ token.
delete_expense
ChatGPTDelete (soft-delete) an expense. DESTRUCTIVE — requires confirm: true (only pass it after the user explicitly confirmed). Refuses (409 conflict) if the expense is billed on an invoice. Requires a write-scoped Manager+ token.
delete_time_entry
ChatGPTDelete (soft-delete) a time entry. DESTRUCTIVE — requires confirm: true (only pass it after the user explicitly confirmed). Refuses (409 conflict) on invoiced entries.
get_client
ChatGPTGet a single client by ID. Returns the full client incl. billing address + per-client billing defaults. Requires a Manager+ token — Member tokens get forbidden_scope.
get_connection_profile
ChatGPTUse this first for conversation context: the acting user/membership, selected workspace, current permissions/plan, date/time preferences, timezone, current local calendar date and app links. Use userId for 'my' work because authorized team lists can contain teammates. Resolve 'today' and 'last week' in this timezone. Present dates through these display preferences: mdy = MM/DD/YYYY, dmy = DD/MM/YYYY, iso = YYYY-MM-DD (numeric dates, even if the prompt uses a month name); medium follows locale; custom uses dateFormatCustom. For times, h12 uses a 12-hour clock with AM/PM and h24 uses a 24-hour clock, in the profile timezone. Timer start/stop is unavailable regardless of read or write consent; do not suggest reauthorization will enable it or substitute a completed time entry. This tool does not switch workspace.
get_expense
ChatGPTGet an expense by ID. Requires a Manager+ token — Member tokens get forbidden_scope.
get_invoice
ChatGPTGet a single invoice by ID. Returns the frozen snapshot — bill-to, line items, totals. Manager+ tokens only.
get_me
ChatGPTResolve the calling token's identity. Use this first to learn what the token can do. Returns { orgId, orgName, plan, role, tokenName, scopes[] } where role is OWNER/ADMIN/MANAGER/MEMBER and scopes is a subset of ["read","write"]. Member tokens additionally return projectIds — the projects they can see — so you can avoid trial-and-error 404s.
get_member
ChatGPTGet a member by ID. Member tokens may only fetch their own row (anyone else's id returns 404).
get_organization
ChatGPTGet details for the organization this token belongs to: name, plan, default currency, invoice prefix, legal name, business contact info. Member tokens receive the identity subset only — invoicePrefix, legalName, taxId, businessEmail, and businessWebsite are omitted for them.
get_project
ChatGPTGet a project by ID. Applicable money fields come back as decimal strings; hourlyRate is null unless rateType is HOURLY, so a dormant compatibility rate on FIXED/NON_BILLABLE is never presented as live pricing. For Member tokens money and fixed-fee reconciliation fields are omitted entirely — budgetHours stays.
get_running_timer
ChatGPTRead the currently-running timer for this user (if any). Returns the first running entry or an empty list. This integration cannot start or stop a timer, even with write consent; offer the Hoursmith workspace link instead of requesting broader permission or creating a completed time entry.
get_task
ChatGPTGet a task by ID. Includes its assignee list (assigneeIds).
get_team_bill
ChatGPTGet an internal bill's frozen lines, dates, grouped display choices, settlement balances, recorded payment references and latest 50 email delivery summaries plus emailDeliveryCount. Previews, bank details and message content are excluded. Attachment links require an Owner/Admin browser session. Sending email does not mean payment. This tool does not generate, send or pay a bill. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Studio+ can read finalized history; drafts require Agency. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.
get_team_payee
ChatGPTGet one payout recipient's private dated rates, credits, and up to 100 active receiving-method labels plus receivingMethodCount by payee ID. No bank details or encrypted data are returned. Use returned userId to correlate general member data. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.
get_team_payment
ChatGPTRead one recorded payment, actual transfer and bill settlement amounts/currencies, bill references and reversal evidence. The tool never sends money or email. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Studio+ can read finalized history; drafts require Agency. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.
get_team_payout_summary
ChatGPTGet currency-separated compensation awaiting review, outstanding/overdue balances and recorded payments. Dates filter estimates and payments; outstanding/overdue are current balances. Client/project filters select whole matching bills and payments, not prorated amounts. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.
get_team_profitability
ChatGPTCompare configured recipients' compensation with attributed client service revenue, or inspect cash movement. Returns member totals and project details, original-currency amounts, report estimates and missing FX. Page/perPage paginate members; complete filtered totals remain separate. Cash difference is not profit. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.
get_time_entry
ChatGPTGet a single time entry by ID.
list_clients
ChatGPTList clients in the organization. Returns paginated results — pass cursor from a previous response's pagination.nextCursor to get the next page. Use search for partial-name lookup (e.g. search="Coffee" finds Coffee Coders). Exact country/currency filters accept both a singular value and plural arrays; they merge with duplicates removed. Allowed sort fields: relevance, id, name, createdAt, updatedAt. Prefix with '-' for descending. Default is newest first (-createdAt). Requires a read-scoped Manager+ token — Member tokens get forbidden_scope (Members have no client access in Hoursmith).
list_expenses
ChatGPTList expenses. Requires a Manager+ token — Member tokens get forbidden_scope. Filter by client, project, category, date range, amount range, or billable flag. Singular and plural exact filters merge and deduplicate before forwarding. Allowed category values: TRAVEL, MEALS, SOFTWARE, EQUIPMENT, CONTRACTORS, OTHER. Allowed sort fields: relevance, id, expenseDate, amount, createdAt, updatedAt. Default -createdAt.
list_invoices
ChatGPTList invoices. Read-only in v1 — invoice POST/PATCH/DELETE land in v1.1. Manager+ tokens only (Member tokens get forbidden_scope). Recipe — find the latest paid invoice for a client by name in one call: set clientName (partial-match on the client's name), status: "PAID", sort: "-paidAt", limit: 1. Date ranges accept YYYY-MM-DD or full ISO timestamps; numeric ranges accept decimal-strings to preserve precision. Singular and plural exact filters merge and deduplicate before forwarding. Allowed sort fields: relevance, id, number, status, paymentStatus, issueDate, dueDate, sentAt, paidAt, total, amountPaid, createdAt, updatedAt.
list_members
ChatGPTList members of the organization (Owner/Admin/Manager/Member). Member tokens see only their own row. Allowed sort fields: relevance, id, role, createdAt.
list_projects
ChatGPTList projects in the organization. Optionally filter by client (id or name) or status. Member tokens see only projects they've been added to, Singular and plural exact filters merge and deduplicate before forwarding. and money/reconciliation fields (hourlyRate, fixedFeeAmount, fixedFeePriorInvoicedAmount, fixedFeeBillingInitializedAt, budgetAmount) are omitted from their results. Allowed sort fields: relevance, id, name, status, startDate, dueDate, createdAt, updatedAt. Default -createdAt.
list_tasks
ChatGPTList tasks. Optionally filter by project, status, priority, assignee, due date, billable, etc. Member tokens see only their assigned projects' tasks. Singular and plural exact filters merge and deduplicate before forwarding. Billability follows the current project model: only HOURLY project tasks can be billable; billable=false also finds legacy rows on FIXED/NON_BILLABLE projects. Allowed sort fields: relevance, id, name, status, priority, startDate, dueDate, endDate, createdAt, updatedAt. Default -createdAt.
list_team_bills
ChatGPTList internal compensation bills and balances. Use outstandingOnly=true for unpaid and partially paid approved bills, or overdueOnly=true for overdue balances. Dates select overlapping service periods. Deleted drafts/void bills are omitted; direct get preserves historical references. Allowed sort fields: id, number, status, issueDate, dueDate, total, amountPaid, createdAt, updatedAt. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Studio+ can read finalized history; drafts require Agency. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.
list_team_payees
ChatGPTList recipients with a configured hourly compensation rate, including retained removed-member profiles. Returns private dated rate history and available credits. Search matches name/email. Allowed sort fields: id, name, createdAt, updatedAt. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.
list_team_payments
ChatGPTRead prior externally recorded team payments and reversals. Dates filter payment dates. Includes actual cash amount/currency and bill-currency settlement allocations, preserving agreed exchange rates. Filter by billId or status RECORDED/REVERSED. Allowed sort fields: id, paidDate, amount, createdAt. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Studio+ can read finalized history; drafts require Agency. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.
list_team_unpaid_time
ChatGPTFind priced, unclaimed time awaiting a compensation bill. Running, deleted, pre-start, unpriced and already-approved time is omitted. Defaults to payable work; nonbillable work remains optional and requires explicit bill selection. Dates filter work dates. For already-approved but unpaid work, use list_team_bills with outstandingOnly=true. Allowed sort fields: id, entryDate, durationSeconds, createdAt. Read-only. Owner/Admin token with read scope required; Manager/Member tokens cannot access any Payouts data. Agency plan required. Money values are exact decimal strings. App links require an authenticated Owner/Admin session.
list_time_entries
ChatGPTList time entries. Filter by project, task, user, date range, billable flag, or set running=true to get the currently-running timer. Singular and plural exact filters merge and deduplicate before forwarding. Billability follows the current project model: only HOURLY project time can be billable; billable=false also finds immutable legacy rows on FIXED/NON_BILLABLE projects. Two different date ranges are available: entryDate* is the calendar day an entry is filed under, startedAt* is when the work actually began. Member tokens are pinned to their own user. Allowed sort fields: relevance, id, entryDate, startedAt, durationSeconds, createdAt, updatedAt. Default is -createdAt (newest first).
update_client
ChatGPTOverwrite the supplied fields of an existing client; omitted fields are left untouched. Requires a write-scoped Manager+ token. Returns the updated client.
update_expense
ChatGPTOverwrite the supplied fields of an expense; omitted fields are preserved. Requires a write-scoped Manager+ token. Refuses (409 conflict) if the expense has already been billed on an invoice (billed expenses are locked).
update_project
ChatGPTOverwrite the supplied fields of a project; omitted fields are preserved. Requires a write-scoped Manager+ token. Use status to mark a project COMPLETED or re-ACTIVATE it. Project Decimal fields accept at most 2 decimal places. Omit a field to preserve it; send null for a nullable field to clear it. Converting away from FIXED requires fixedFeeAmount: null. The same coherence rules as create_project apply when you touch the relevant fields.
update_task
ChatGPTOverwrite the supplied fields of a task; omitted fields are preserved. Requires a write-scoped token; Members may only edit tasks assigned to them. Adding another current workspace member as an assignee can send the task name and link through external email or linked Telegram providers, according to that recipient's saved notification preferences. Destinations come from the member's existing profile, not a caller-supplied address. Sent notifications cannot be recalled; unchanged assignees, self-assignment and removals do not send assignment notifications. Same field types as create_task — billable is a real boolean and is forced false for FIXED/NON_BILLABLE projects; estimatedHours is a number or decimal-string.
update_time_entry
ChatGPTOverwrite the supplied fields of a time entry; omitted fields are preserved. Refuses (409 conflict) if the entry is already on an invoiced bill — invoiced entries are immutable. Same dual-input duration rule as create_time_entry: prefer durationSeconds. startTime/endTime behave as they do on create; omit them to leave the entry's bookends alone, or send null for BOTH to clear them. If the target project is FIXED or NON_BILLABLE, billable is always stored as false.
add_expense_to_invoice
Claudeadd_project_member
Claudeadd_team_pay_rate
Claudeapprove_and_pay_team_bill
Claudeapprove_team_bill
Claudearchive_project
Claudearchive_task
Claudearchive_team_fixed_pay_agreement
Claudebulk_delete_time_entries
Claudebulk_set_time_entries_billable
Claudecancel_invoice
Claudeclone_recurring_invoice
Claudecorrect_invoice
Claudecreate_client
Claudecreate_client_contact
Claudecreate_expense
Claudecreate_invoice
Claudecreate_project
Claudecreate_recurring_invoice
Claudecreate_task
Claudecreate_team_bill_draft
Claudecreate_team_bill_drafts_bulk
Claudecreate_team_fixed_pay_agreement
Claudecreate_time_entry
Claudedelete_client
Claudedelete_client_contact
Claudedelete_expense
Claudedelete_invoice
Claudedelete_team_bill
Claudedelete_time_entry
Claudediscard_timer
Claudeduplicate_invoice
Claudeend_recurring_invoice
Claudegenerate_next_recurring_invoice
Claudeget_cash_flow
Claudeget_client
Claudeget_connection_profile
Claudeget_dashboard_overview
Claudeget_expense
Claudeget_invoice
Claudeget_me
Claudeget_member
Claudeget_organization
Claudeget_project
Claudeget_project_archive_impact
Claudeget_project_financials
Claudeget_project_profitability
Claudeget_receivables_summary
Claudeget_recurring_invoice
Claudeget_revenue_report
Claudeget_running_timer
Claudeget_task
Claudeget_task_checklist
Claudeget_team_bill
Claudeget_team_payee
Claudeget_team_payment
Claudeget_team_payout_summary
Claudeget_team_profitability
Claudeget_time_entry
Claudeget_time_summary
Claudeget_uninvoiced_summary
Claudelist_client_contacts
Claudelist_clients
Claudelist_expenses
Claudelist_invoice_activity
Claudelist_invoice_payments
Claudelist_invoices
Claudelist_members
Claudelist_notifications
Claudelist_payment_methods
Claudelist_project_members
Claudelist_projects
Claudelist_ready_to_invoice
Claudelist_recurring_invoice_occurrences
Claudelist_recurring_invoices
Claudelist_tasks
Claudelist_team_bills
Claudelist_team_fixed_pay_agreements
Claudelist_team_payees
Claudelist_team_payments
Claudelist_team_payout_methods
Claudelist_team_unpaid_time
Claudelist_time_entries
Claudemark_invoice_sent
Claudemark_notifications_read
Claudepause_recurring_invoice
Claudepreview_invoice
Claudepreview_invoice_email
Claudepreview_team_bill
Claudepreview_team_bills_bulk
Clauderecord_invoice_payment
Clauderecord_team_payment
Clauderefund_invoice_payment
Clauderemove_project_member
Clauderestore_invoice_to_draft
Clauderestore_project
Clauderestore_task
Clauderesume_recurring_invoice
Claudereverse_team_payment
Claudesave_team_payee
Claudesend_invoice
Claudesend_invoice_reminder
Claudeset_invoice_reminder_schedule
Claudeset_task_checklist
Claudeskip_recurring_invoice_occurrence
Claudestart_timer
Claudestop_timer
Claudeundo_skip_recurring_invoice_occurrence
Claudeupdate_client
Claudeupdate_client_contact
Claudeupdate_expense
Claudeupdate_invoice
Claudeupdate_organization
Claudeupdate_project
Claudeupdate_recurring_invoice
Claudeupdate_running_timer_note
Claudeupdate_task
Claudeupdate_team_bill_draft
Claudeupdate_time_entry
Claudevoid_team_bill
Claude