MCP App Store
by KeenEthics

Overview

JobSnap is the job management app for construction and field-service crews. Connect your JobSnap account to ask about your company in plain language and get things done without opening the app. See who is clocked in and on which job, total hours by person or job, check and change the crew schedule, read daily reports, find notes, photos and job files, review material costs and time-off requests, and create or update jobs, customers, estimates and invoices. JobSnap acts as you, with your role. A worker sees their own shifts and schedule; owners and admins see the whole company. Anything that changes data is confirmed with you first. You need an existing JobSnap account; you can disconnect at any time from JobSnap settings.

Tools

add_absence

ChatGPT
Mark a person as absent (sick, leave, weather or other) for a day or a range of days (YYYY-MM-DD, team timezone), like the app's 'I did not work' dialog on an empty timesheet day. One absence per day: an existing absence that day gets its reason changed. Refused for days that already have shifts and for days in a locked pay period. Workers can only mark themselves. For planned vacation, prefer request_time_off + approve_time_off. Undo with remove_absence. (Changes data.)

add_shift

ChatGPT
Add a completed shift manually (forgot to clock in). Times are YYYY-MM-DDTHH:MM in the team's local time (offset optional). A shift is one day: start and end on the same local day; work past midnight = two shifts. (Changes data.)

approve_joining_request

ChatGPT
Let a requester join the team (id from list_joining_requests). They become an active member with the given role (default worker, like the app). Refuses if an active member already has their email or phone. (Changes data.)

approve_material_cost

ChatGPT
Approve a pending material cost. (Changes data.)

approve_time_off

ChatGPT
Approve a pending time-off request and record the days as leave. (Changes data.)

assign_equipment

ChatGPT
Set who holds a piece of equipment, or unassign it (used_by_member_id null). Does not change its status. Membership id from list_members (id, not user_id); equipment id from list_equipment. (Changes data.)

award_pay_item

ChatGPT
Give an employee a standalone pay item on a calendar day, without a shift. Uses the configured price. manual_roles must allow your role; [] is automatic only. Workers may award only themselves. Locked periods require an admin unlock. Use list_pay_items for the value it accepts. Reuse request_id when retrying the same award to prevent double pay. (Changes data.)

cancel_time_off

ChatGPT
Cancel (delete) your own time-off request while it is still pending, like the Delete button in the app. Approved or denied requests can't be cancelled this way. Ids from list_time_off. (Changes data.)

clock_in

ChatGPT
Start an open shift on a job (no end time). Fails if the person already has an open shift. (Changes data.)

clock_out

ChatGPT
End an open shift; computes hours and applies the team's automatic break rule. ALWAYS pass end_time when closing a forgotten shift from an earlier day (defaults to now, refused when that would book more than 16h). Pass shift_id when the person has several open shifts. (Changes data.)

convert_estimate_to_invoice

ChatGPT
Create a draft invoice from an estimate (same customer, job, line items and tax rate; next INV- number; due date from the team setting / 30 days), like the app's Create invoice action. The estimate itself is left unchanged; use update_estimate to mark it accepted/completed. (Changes data.)

create_crew

ChatGPT
Create a crew with a foreman (required, like the app), an optional name and colour, and optionally its members (same effect as set_crew_members). Put it on jobs afterwards with schedule_job. user ids from list_members. (Changes data.)

create_customer

ChatGPT
Create a customer record (name, plus optional email, phone, address and notes) that jobs, estimates and invoices can be attached to. Check list_customers first to avoid a duplicate. (Changes data.)

create_equipment

ChatGPT
Add a piece of equipment (tool, vehicle, machine) to the team's equipment list. Starts as available unless a status is given. Optionally assign it to a member (membership id from list_members). Use set_equipment_status / assign_equipment / update_equipment to change it later. (Changes data.)

create_estimate

ChatGPT
Create an estimate (draft unless status given). (Changes data.)

create_form

ChatGPT
Build a new custom form. fields are in display order; types: shortAnswer, paragraph, email, phone, website, dropdown/multipleChoice (need options), checkbox, number (min/max), rating (1-5 by default), date, time, datetime, jobSelector, userSelector, equipmentSelector. Unpublished by default: set is_published true to let the crew fill it. (Changes data.)

create_group

ChatGPT
Start a named group conversation with teammates (user_ids from list_members; the user is added automatically), optionally with a first message from the user. Returns the channel id for send_chat_message. (Changes data.)

create_invoice

ChatGPT
Create an invoice (draft unless status given). (Changes data.)

create_job

ChatGPT
Create a job. The site address is required and is geocoded so the job can be geofenced: run geocode_address first and pass the confirmed latitude/longitude. (Changes data.)

create_job_task

ChatGPT
Add a task from the team's task list to a job (task ids from list_job_tasks → available_tasks), optionally with a quantity and job-specific name/number/unit/description. (Changes data.)

create_line_item_template

ChatGPT
Save a reusable line item template. (Changes data.)

create_material_cost

ChatGPT
Record a material cost (manual entry, PO, bill or receipt) with line items. Submitted for approval (status pending) unless draft is true. (Changes data.)

create_note

ChatGPT
Create a note for the user (markdown body, optional todos). (Changes data.)

create_supplier

ChatGPT
Add a supplier / vendor. Refuses if one with the same name exists (returns its id). Check list_suppliers first. (Changes data.)

create_task

ChatGPT
Add a task to the team's catalogue. category groups tasks (reuse an existing one from list_tasks when it fits). (Changes data.)

create_work_order

ChatGPT
Create a work order; only title is required. Reuse request_id when retrying to get the same number. Optional forms, crew/member assignments and job/customer/machine links. (Changes data.)

delete_cost_object

ChatGPT
Delete a cost object that nothing has been charged to. If anything was charged, archive it with save_cost_object instead. Confirm with the user first. (Changes data.)

delete_crew

ChatGPT
Delete a crew. Its members stay on the team (unassigned) and their schedule entries from this crew are removed; the job's calendar blocks keep their dates but no longer have a crew. Crew ids from list_crews. (Changes data.)

delete_customer

ChatGPT
Permanently delete a customer. Their jobs, estimates and invoices are kept but still point at the deleted customer id. Confirm with the user first. (Changes data.)

delete_equipment

ChatGPT
Permanently delete a piece of equipment from the team's list (its past usage logs stay). Confirm with the user first. (Changes data.)

delete_estimate

ChatGPT
Permanently delete an estimate. Confirm with the user first. (Changes data.)

delete_invoice

ChatGPT
Permanently delete an invoice. Confirm with the user first. (Changes data.)

delete_job

ChatGPT
Permanently delete a job, like the job form's Delete. Only possible while nobody has logged time on it (otherwise set it inactive with update_job). Can't be undone. (Changes data.)

delete_job_task

ChatGPT
Remove a task from a job (the task stays in the team's task list). (Changes data.)

delete_line_item_template

ChatGPT
Delete a line item template. Existing estimates/invoices keep their copied lines. (Changes data.)

delete_material_cost

ChatGPT
Permanently delete a material cost / receipt. Owners, admins and managers can delete any; others only their own while draft or pending. Confirm with the user first. (Changes data.)

delete_note

ChatGPT
Delete a note you wrote or one shared with the team, with its photos and recordings. Can't be undone. (Changes data.)

delete_pay_item

ChatGPT
Delete a pay item and its automatic rules. It's no longer offered on shifts or as a job default; shifts that already have it keep it. Awards already given stay on reports and are never changed. (Changes data.)

delete_photo

ChatGPT
Permanently delete a job photo (the file and its gallery entry). Photo id from list_job_photos. (Changes data.)

delete_shift

ChatGPT
Permanently delete one shift entry (id from get_shifts). Refused in a locked pay period. Confirm with the user first. (Changes data.)

delete_work_order

ChatGPT
Delete a cancelled work order only if no costs have been charged. Owner/admin/manager only. (Changes data.)

deny_joining_request

ChatGPT
Turn down a joining request (id from list_joining_requests): the request is deleted, nobody is added. (Changes data.)

deny_time_off

ChatGPT
Deny a pending time-off request (id from list_time_off). The employee sees it as denied; it cannot be approved afterwards. (Changes data.)

duplicate_estimate

ChatGPT
Copy an estimate (customer, job, line items, tax, notes, validity) into a new draft with the next EST- number, like the app's Duplicate action. estimate_id from list_estimates. (Changes data.)

duplicate_invoice

ChatGPT
Copy an invoice into a new draft with the next INV- number and a fresh due date (team setting / 30 days), like the app's Duplicate action. invoice_id from list_invoices. (Changes data.)

export_timesheet

ChatGPT
Timesheet for a pay period as CSV text (hours are decimal, dates YYYY-MM-DD in the team's timezone). layout 'summary' (default) matches the app's payroll export: per employee one row per job (Employee, Start date, End date, Job, Total hours[, Rounded total]), then a Rounding row and a Total row. layout 'shifts' lists every shift and absence day (Employee, Date, Type, Job, Start, End, Break minutes, Hours, Notes). Omit dates for the current pay period. The app's Excel (.xlsx) file itself isn't produced here.

fetch

ChatGPT
Full text of one search result by its id from search (e.g. job:abc, estimate:xyz, note:123). Returns { id, title, text, url, metadata }; text is markdown with line items and totals for estimates, invoices and material costs. Permissions are re-checked.

file_to_job

ChatGPT
Put a copy of a file (a chat attachment's url or storage_path) into a job's Files tab, in a folder (created if new). The original stays where it is. (Changes data.)

geocode_address

ChatGPT
Look up an address and return up to 3 matches with coordinates. Do this before creating a job and confirm the match with the user when there is more than one.

get_customer

ChatGPT
One customer in full: contact details, notes, their jobs, estimates and invoices (numbers, status, totals).

get_daily_report

ChatGPT
One person's daily report for a day in full: per job, each answer with its field label, and whether it was submitted. Pass report_id (from list_my_daily_reports / get_daily_reports) or a date (+ user_id; default yourself). Workers can open only their own.

get_daily_report_counts

ChatGPT
Who filed daily reports between two dates (inclusive, max 62 days) and how often: per person, days filed (a day counts once any job entry is submitted), job entries submitted, drafts; plus active members who filed none. For one day's contents use get_daily_reports.

get_daily_report_form

ChatGPT
The team's daily report form: each field's id, label, type, whether it's required, and its options. Read it before submit_daily_report / update_daily_report to know the field ids.

get_daily_reports

ChatGPT
Daily reports for a day: who filed, per-job entries and answers. For who filed over a date range (and how often) use get_daily_report_counts.

get_equipment

ChatGPT
One piece of equipment in full: type, model, number, status, who holds it, and its recent usage log per job.

get_estimate

ChatGPT
One estimate in full: line items with totals, subtotal, tax, total, customer, job, validity.

get_form

ChatGPT
A form's settings and its fields in order (id, type, label, required, options/choices, limits). Field ids are the keys submit_form expects.

get_invoice

ChatGPT
One invoice in full: line items with totals, subtotal, tax, total, customer, job, due date.

get_job

ChatGPT
Full job record including tasks and schedule blocks.

get_material_cost

ChatGPT
One material cost / receipt in full: line items, subtotal, tax, total, vendor, status. Foremen and workers can open only their own.

get_member

ChatGPT
One team member in full: contact details, role, employee number, crews, whether they're clocked in now. Workers can open only themselves.

get_note

ChatGPT
One note by id (from list_notes or search_notes): full markdown body and its todos.

get_pay_period_summary

ChatGPT
Payroll summary for one pay period: per person, paid hours (after breaks), break and on-site minutes, days worked, hours per job, open shifts, absence days by reason, rounded total (team rounding setting), whether they've been checked off as reviewed and whether they have a personal unlock. Omit dates for the current period from the team's payroll settings (period_index 1 = previous). The app computes no overtime, so none is returned. Related: list_pay_periods, lock_pay_period, mark_payroll_reviewed, export_timesheet.

get_photo

ChatGPT
One job photo by id (from list_job_photos / search_team_photos) with its description and a download url valid about 1 hour.

get_quickbooks_status

ChatGPT
Whether the team is connected to QuickBooks Online (company, who connected it, when), which JobSnap records are auto-created in QuickBooks, and the last sync. Pass entity_id (a customer, job, estimate or invoice id) to check whether that record is linked to QuickBooks. Linked records sync automatically whenever they change.

get_schedule

ChatGPT
Who is scheduled on which job between two dates (crew schedules). Workers see their own.

get_shifts

ChatGPT
List shifts (time entries) in a date range. Workers see only their own. Returns hours worked, breaks, job and notes.

get_team

ChatGPT
The company's settings: name, timezone, address, public email/phone, job statuses (names + '#RRGGBB' colours, is_active), GPS tracking level, time settings (start of work day HH:MM, require GPS, allow time edits, automatic break in minutes), daily report settings (due time HH:MM, summary recipients as user ids, field labels) and enabled features. Owners/admins also see estimate/invoice defaults (tax_rate is a PERCENT, periods in minutes).

get_work_order

ChatGPT
Work order with forms/submission status, status history, costs (including who recorded each and unassigned markers), photos and invoices. Invoice data is limited to owner/admin.

grant_pay_period_unlock

ChatGPT
Let one person's time be edited again inside a closed (locked) pay period, like the lock icon next to a name on the app's payroll screen; granted=false takes the unlock back. The period stays locked for everyone else. Dates are the pay period's first and last day (YYYY-MM-DD, inclusive); omit them for the current period (period_index 1 = previous). To reopen the whole period use lock_pay_period with locked=false. (Changes data.)

invite_member

ChatGPT
Add a new employee. Owners/admins create the member directly (role default worker; the app texts/emails them a sign-in link when they have a phone or email; with neither they're a stub who can't sign in yet). Managers/foremen can't create members: this files a joining request (full name, email AND phone required) that an owner/admin approves with approve_joining_request. Refuses if an active member already has that email or phone. (Changes data.)

list_channels

ChatGPT
The user's chat conversations, most recent first: the company channel, groups, job chats and direct messages they belong to, with the last message. Channel ids feed read_channel and send_chat_message.

list_cost_objects

ChatGPT
The team's costing setup: Equipment Repair on/off, the groups (max 3), whether work orders are enabled, and the cost objects (things like Safety, Travel, Training that time and costs can be charged to instead of a job).

list_crews

ChatGPT
Crews with foreman, members and assigned jobs.

list_customers

ChatGPT
Search customers by name, email, phone or address.

list_equipment

ChatGPT
Equipment with status (e.g. available / in use / maintenance / broken) and who has it.

list_estimates

ChatGPT
Estimates with customer name and total, optionally by status (one or several) or customer, plus the total number matching.

list_form_submissions

ChatGPT
Submitted forms, newest first, with every answer. Filter by form and/or by the job picked in a job field. Owner/admin/manager/foreman see everyone's; workers see only their own.

list_forms

ChatGPT
The team's custom forms (inspections, checklists, sign-offs…), newest first. Workers only see published forms. Use get_form for a form's fields, submit_form to fill one.

list_invoices

ChatGPT
Invoices with customer name and total, optionally by status (one or several) or customer, plus the total number matching. Due dates are ISO strings.

list_job_files

ChatGPT
Files and folders in a job's Files tab (optionally inside a folder, e.g. 'Plans/2026'). Use it to pick an existing folder name before filing something.

list_job_photos

ChatGPT
Job photos, newest first, with the AI description and a download url valid about 1 hour. Filter by job, uploader and/or a date range (YYYY-MM-DD, team timezone, inclusive). For finding photos by what they show, use search_team_photos.

list_job_tasks

ChatGPT
Tasks (cost codes from the team's task list) assigned to a job, with quantity and unit, plus available_tasks: active catalog tasks not yet on the job (their ids go to create_job_task).

list_jobs

ChatGPT
Search jobs by name, number, client or address. Returns id, status, address, customer, and the total number of matches.

list_joining_requests

ChatGPT
People waiting to join the team (from the invite link, company search, or a foreman/manager's invite), newest first. Approve with approve_joining_request or deny with deny_joining_request.

list_line_item_templates

ChatGPT
The team's reusable line items (title, description, default unit price, unit), A→Z, optionally filtered by text. Use them to fill line_items in create_estimate/create_invoice (quantity 1 by default).

list_material_costs

ChatGPT
Material costs / receipts / POs, optionally by job or status, with each one's total and the total number matching. Foremen and workers see only the ones they filed.

list_members

ChatGPT
Team roster with roles and user ids.

list_my_daily_reports

ChatGPT
Your own daily reports between two dates (default the last 14 days): date, jobs reported, submitted or draft. For the whole team on one day use get_daily_reports.

list_notes

ChatGPT
The user's notes (and, with include_team, notes shared with the team): title, kind, todos, linked job/customer.

list_pay_item_awards

ChatGPT
Automatic (rule) and standalone manual pay item awards, with ids, source, day, rule, period (a shift/day/week key), employee, amount and waived flag; waived awards are excluded from totals. Workers see their own only. Items picked on a shift are in get_shifts.

list_pay_items

ChatGPT
The team's pay items (travel, allowances, per diems paid on top of hours) and what each accepts, who can add each by hand (manual_roles, can_add) and whether it is also awarded automatically, plus a job's defaults when job_id is given. Owners/admins also get each item's automatic rules. Use before setting pay_items on a shift or editing rules.

list_pay_periods

ChatGPT
Pay periods with locked state, plus who has been checked off (reviewed) in each.

list_suppliers

ChatGPT
The team's suppliers / vendors (name, email, phone, address, notes), alphabetical, optionally filtered by name. Use the id as supplier_id on material costs.

list_tasks

ChatGPT
The team's task catalogue (cost codes / work items people log time and quantities against), grouped by category. Inactive tasks are hidden unless include_inactive.

list_teams

ChatGPT
Every company this user is an active member of, with their role in each. Use switch_team to change which one the tools act on.

list_time_off

ChatGPT
Time-off requests, optionally filtered by status or person. Only owner/admin/manager see other people's.

list_todos

ChatGPT
Your open todos across your own notes (like My TODO's), grouped by note, newest note first. include_done adds ticked ones. Tick with set_todo_done.

list_work_orders

ChatGPT
List/search work orders by number or title, optionally mine, status, assignee, job, customer or machine. Defaults to open, in-progress and on-hold. Existing records remain readable when work orders are disabled.

lock_pay_period

ChatGPT
Lock (close) or unlock a pay period, given its first and last day. Creates the period record if the app hasn't yet. (Changes data.)

log_equipment_time

ChatGPT
Log equipment usage on a job (minutes) for a day. (Changes data.)

mark_payroll_reviewed

ChatGPT
Check off (or uncheck) an employee as reviewed for a pay period. (Changes data.)

message_member

ChatGPT
Send a direct message to a teammate on the user's behalf, in their DM thread; the teammate gets a push notification. Use it for "let X know…". It goes out under the user's name, so write the text in their voice, first person, ready to read as-is. (Changes data.)

move_job_file

ChatGPT
Move or rename a file inside a job's Files tab (paths from list_job_files). to_path may be a folder (ending in '/') to keep the name. (Changes data.)

read_channel

ChatGPT
Recent messages of a conversation the user belongs to (channel id from list_channels), oldest to newest, with sender names. since = only messages from that time on (YYYY-MM-DDTHH:MM, team timezone).

read_job_file

ChatGPT
Read the text of a job file (PDF or text-like; path from list_job_files).

remove_absence

ChatGPT
Remove the absence recorded on one day (YYYY-MM-DD) for a person, like clearing the reason in the app's absence dialog. Refused in a locked pay period. To cancel approved time off as a whole, ask an owner/admin to delete the request in the app. (Changes data.)

remove_member

ChatGPT
Remove someone from the team (user_id from list_members), like the app's delete: a still-pending invitation is deleted outright; anyone who joined is marked deleted + inactive (their time and history stay). An owner can only be removed by an owner, and never the last active owner. (Changes data.)

remove_pay_item_award

ChatGPT
Remove a standalone manual award (id from list_pay_item_awards). Checks current manual_roles and the pay-period lock. Automatic awards must be changed through their rule or source; they cannot be removed by hand. (Changes data.)

request_time_off

ChatGPT
File a time-off request for the user themself (always pending; nobody can file for someone else). (Changes data.)

restore_pay_item_award

ChatGPT
Pay a waived automatic award again (re-checks the rule). Owner/admin only. Id from list_pay_item_awards. (Changes data.)

save_cost_object

ChatGPT
Create a cost object (omit cost_object_id) or edit one: name, group (id from list_cost_objects, null for none), optional code such as a GL account, archived. Archive instead of deleting once anything has been charged. (Changes data.)

save_pay_item

ChatGPT
Create or edit a pay item (travel, allowance, per diem…) paid on top of hours, optionally with automatic rules (e.g. a bonus when a shift exceeds 9 hours or the daily report is on time). Rule awards use the item's price; manual_roles [] makes it automatic only. Omit id to create; with id, only the fields you pass change. Hours are decimal (0.75 = 45 min). choice/dropdown need options; checkbox needs amount; number needs amount (the rate per unit) and number_unit. Shifts already paid keep their price. (Changes data.)

schedule_job

ChatGPT
Put a job on a crew's calendar for a date range (dates only, inclusive). Like the app: weekends and statutory holidays are skipped, overlapping blocks for the same crew are merged, and every crew member gets the days on their schedule. (Changes data.)

search_documents

ChatGPT
Find records by meaning when you don't know the exact name or number (e.g. "the deck job with the rotten joists", "invoice about gutter repairs"). Returns matching text chunks with their record type and id; open the record with the matching get_/list_ tool for details.

search_notes

ChatGPT
Search your notes and notes shared with the team by text (title, body, todos, linked job or customer). Returns previews; open one with get_note.

search_team_photos

ChatGPT
Find job photos by what they show (e.g. "damaged gutter", "blue excavator"), using the photos' AI descriptions. Optionally limit to one job or uploader. Best matches first, each with a download url valid about 1 hour.

send_chat_message

ChatGPT
Post a message as the user into a conversation they belong to (company channel, group, job chat or DM; channel id from list_channels). Members get a push notification. It goes out under the user's name: write it in their voice, ready to read as-is. For a DM to someone without an existing thread, use message_member. (Changes data.)

send_checklist

ChatGPT
Post a checklist as the user into a team conversation they belong to (company channel, group, job chat or DM; channel id from list_channels), e.g. a punch list in a job chat. Items can be assigned to members of that conversation (user_ids from list_members): assigned items show up in that person's My TODOs. For a checklist just for the user, use create_checklist instead. (Changes data.)

set_checklist_items

ChatGPT
Tick or untick items of a checklist in a team conversation (ids from read_channel). Pass every item to change in one call. An assigned item is marked for its assignee, a shared one for the user. thread_root_id when the checklist is a thread reply. For checklists in your own conversation with the user, use tick_checklist. (Changes data.)

set_cost_groups

ChatGPT
Replace the team's cost object groups (max 3, each with a label and an icon). Pass existing ids to rename or reorder; a group that cost objects still use can't be removed. Owner/admin only. (Changes data.)

set_costing_switches

ChatGPT
Turn Equipment Repair charging on or off, and/or enable or disable work orders for the team. Disabling keeps all records and blocks new work orders and new charges. Owner/admin only. (Changes data.)

set_crew_members

ChatGPT
Set exactly who is in a crew (the full list; omitted people are removed). Like dragging people on the app's scheduling whiteboard: a person is in one crew at a time, so anyone added is moved out of their other crew; people added get the crew's scheduled job days on their schedule and people removed lose them. The foreman is separate (update_crew). Ids from list_crews / list_members. (Changes data.)

set_equipment_status

ChatGPT
Set a piece of equipment's status (available, in_use, maintenance, broken) and who holds it. Setting it available releases the holder. (Changes data.)

set_job_pay_item_defaults

ChatGPT
Override, for one job, how pay items start on its new shifts (otherwise each pay item's team show_on_shifts setting applies). defaults: keyed by pay item name or id — option label, true (checkbox), a quantity (number) to pre-fill, or null to go back to the team setting. show: items shown empty for the crew to fill in. hide: items only offered via Add pay item on this job. Other entries on the job stay. See list_pay_items for what each accepts. (Changes data.)

set_quickbooks_auto_create

ChatGPT
Turn QuickBooks auto-create on or off per record type (customers, jobs, estimates, invoices): when on, new JobSnap records of that type are created in QuickBooks automatically. Requires a connected QuickBooks (see get_quickbooks_status). (Changes data.)

set_todo_done

ChatGPT
Tick or untick a todo inside one of the user's notes. (Changes data.)

set_work_order_settings

ChatGPT
Enable/disable work orders or change the number prefix. Existing numbers and records are kept. Owner/admin only. (Changes data.)

submit_daily_report

ChatGPT
Fill in and submit your own daily report for one job on one day, like the Daily report screen. Answers are merged into what's already there (null clears a field). Required fields of the team's form (get_daily_report_form) must be filled to submit; pass submit=false to save a draft. Date defaults to today (team timezone). (Changes data.)

submit_form

ChatGPT
Fill in and submit a published form as the user. answers maps each field id (or exact label) from get_form to its value: text for text/email/phone/website/dropdown fields; a list of option strings for multipleChoice; true/false for checkbox; a number for number/rating; YYYY-MM-DD for date, HH:MM for time, YYYY-MM-DDTHH:MM (team timezone) for datetime; the id for job/user/equipment fields (from list_jobs / list_members / list_equipment, or a listed choice). Required fields must be answered. (Changes data.)

submit_material_cost

ChatGPT
Submit a draft material cost for approval (draft → pending). Foremen and workers can submit only their own. (Changes data.)

summarize_hours

ChatGPT
Total hours per person and per job over a date range. Workers get their own totals only.

switch_job

ChatGPT
Close the current open shift and open a new one on another job at the same instant. (Changes data.)

switch_team

ChatGPT
Make every following call act on another company the user belongs to (see list_teams). Only for external AI clients; the in-app assistant is already scoped.

transition_work_order

ChatGPT
Start, hold, resume, complete, cancel or reopen. Cancellation needs a reason. Required forms must be submitted before completion. Assignees and office roles operate; only owner/admin/manager reopen. (Changes data.)

unschedule_job

ChatGPT
Take a job off a crew's calendar: removes that crew's blocks (all of them, or only those overlapping a date range) and the members' schedule entries. (Changes data.)

update_crew

ChatGPT
Rename a crew, change its colour or its foreman. Members: set_crew_members. Crew ids from list_crews. (Changes data.)

update_customer

ChatGPT
Update a customer's contact details or notes. (Changes data.)

update_daily_report

ChatGPT
Change answers in an existing daily report (yours, or anyone's as owner/admin) for one job. Answers merge into the entry (null clears a field); submitted=true submits it (required fields checked), false puts it back to draft, omitted leaves it as is. An entry left with no answers is removed, and the report with it when empty. (Changes data.)

update_equipment

ChatGPT
Edit a piece of equipment: name, type, model/serial, equipment number, status. Only the fields you pass change; pass null to clear type/model/equipment_number. Ids from list_equipment. To change who holds it use assign_equipment. (Changes data.)

update_estimate

ChatGPT
Update an estimate's status, notes, line items, customer or job. (Changes data.)

update_form

ChatGPT
Change a form's title, description, publishing, public link, notification emails, or replace its fields (pass the full list in order; keep each existing field's id from get_form so past answers stay linked; fields left out are removed). Set deleted true to delete the form. (Changes data.)

update_invoice

ChatGPT
Update an invoice's status (sent/paid/overdue/cancelled), due date, notes, line items, customer or job. (Changes data.)

update_job

ChatGPT
Update a job's name, address, customer, status, sales status or scheduled dates (status/sales status: owner/admin; scheduled dates: owner/admin/manager). (Changes data.)

update_job_task

ChatGPT
Change a job task's quantity or its job-specific name/number/unit/description (null reverts to the task list's value). Ids from list_job_tasks. (Changes data.)

update_line_item_template

ChatGPT
Change a line item template's title, description, default unit price or unit. template_id from list_line_item_templates. (Changes data.)

update_material_cost

ChatGPT
Edit a material cost / receipt / PO (id from list_material_costs). Only the fields you pass change; pass null to clear. line_items REPLACES the whole list (send every line; keep each line's id to keep it). tax_rate is a PERCENT (15 = 15%); changing it drops the printed tax_amount so the rate drives the total, like the app. status may move between draft and pending (use approve_material_cost to approve; moving an approved cost back needs owner/admin/manager). supplier_id (from list_suppliers) also sets vendor_name. Foremen and workers can edit only their own costs, and not once approved. (Changes data.)

update_member

ChatGPT
Edit a team member (user_id from list_members). Owners/admins: first/last name, employee number, role, status (inactive = can't sign in to this team), require GPS, and email/phone only for a member who has neither yet (adding one sends them an invitation). Everyone else may only change their own chat_enabled / daily_reports_enabled notification flags. The owner can't be demoted or deactivated by anyone else, admins can't make owners, and the team always keeps one active owner. (Changes data.)

update_my_email_preferences

ChatGPT
Turn the signed-in user's own weekly emails on or off (Profile settings in the app). weekly_report_emails = their personal weekly timesheet email (their own hours, for every company they're in). weekly_team_report_emails = the weekly team hours report owners get, for every company they own. Per person, not per company; only for the signed-in user. If the user asks for an email or notification setting this doesn't cover, say it can only be changed in the app instead of changing something else. (Changes data.)

update_note

ChatGPT
Edit a note you wrote or one shared with the team: title, markdown body, kind, todos (full list; keep a todo's id to keep it, omit id for a new one), linked job (null unlinks). Only the author can change who sees it (private / team). To just tick a todo use set_todo_done. (Changes data.)

update_shift

ChatGPT
Edit a shift's times (YYYY-MM-DDTHH:MM local), break, job or notes. Hours are recalculated. (Changes data.)

update_supplier

ChatGPT
Edit a supplier (id from list_suppliers). Only the fields you pass change; null clears. Renaming does not rewrite vendor_name on past costs. (Changes data.)

update_task

ChatGPT
Edit a catalogue task (task_id from list_tasks). status inactive hides it from pickers without losing history. (Changes data.)

update_team_settings

ChatGPT
Change company settings, like the app's Company, Time and Daily report settings screens. Only the fields you pass change. job_statuses REPLACES the whole ordered list (read get_team first; existing jobs keep their current status copy). automatic_break: pass null to turn it off. daily_report_due_time is HH:MM on the hour or half hour; summary recipients are user ids from list_members. Can't touch billing/trial. (Changes data.)

update_work_order

ChatGPT
Update only the named fields. assignee_ids and forms replace their lists; crew_ids adds current crew members. Use [] to detach all forms or unassign everyone. (Changes data.)

waive_pay_item_award

ChatGPT
Set aside an automatic (rule) award so it is not paid; it is kept so its rule can't recreate it. Owner/admin only; locked periods need an unlock. Undo with restore_pay_item_award. Id from list_pay_item_awards. (Changes data.)

who_is_clocked_in

ChatGPT
Who is clocked in right now: open shifts started today (workers: only themselves). Open shifts from earlier days are not counted as clocked in; they are reported separately as missing_end_time (count plus the 10 most recent) so they can be fixed with clock_out and an end_time.

whoami

ChatGPT
The member these tools act as: user id, name, role, team and timezone.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps