First-party app
Jobber

Jobber

Jobber field-service management — clients, properties, requests, quotes, jobs, visits and invoices — over Jobber's GraphQL API.

stable Calendar & SchedulingCustomer Relationship ManagementFinance & Accounting

About

Jobber ships in the w6w first-party pack. It declares 28 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.jobber
Version
0.1.2
Author
w6w
Licence
MIT
Categories
Calendar & Scheduling · Customer Relationship Management · Finance & Accounting

Overview

Jobber runs the office side of a home-service business — plumbing, landscaping, HVAC, cleaning — and this app models the chain that is the product: a request becomes a quote, a quote becomes a job, a job is made of visits, and completed visits become an invoice, over Jobber’s own GraphQL API.

It covers clients and their serviced properties, work requests, quotes (create and approve), jobs created from an approved quote, visits (create, list, complete) and invoices generated straight from a job’s uninvoiced work. An escape-hatch action runs any GraphQL query or mutation directly, reaching timesheets, expenses, job costing, payouts and everything else in Jobber’s much larger schema that the named actions don’t cover.

Good for turning an external booking or web-form request into a Jobber request automatically, converting an approved quote into a scheduled job, generating and marking invoices as sent once a job wraps up, or syncing visit schedules with a dispatch or calendar tool.

Build with Jobber

Three routes to the same 28 actions. The Workflow tab is generated from Jobber's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Get Account

account-get

Fetch the Jobber account this connection authorises — id, company name, industry, country and active user count.

Archive Client

client-archive

Archive a client. Reversible, and non-destructive — their history is retained. Jobber rejects the archive if the client still has open work.

Create Client

client-create

Create a client, optionally with a primary email, phone and one service property. Fails loudly on Jobber's `userErrors`.

Edit Client

client-edit

Update a client's name, billing address, notification settings, and append an email, phone or tags. Only fields you set are touched.

Get Client

client-get

Fetch one client by id, with their first 10 service properties. Returns `client: null` when the id does not belong to the connected account.

List Clients

client-list

Search and page through clients. Returns one cursor page — read `pageInfo.endCursor` and pass it back as `after` for the next.

Run GraphQL Query

graphql-query

Send an arbitrary query or mutation to Jobber's GraphQL API, pinned to this app's API version. Returns `data` and `extensions`. Mutations must select and check `userErrors` themselves.

Create Invoice from Job

invoice-create-from-job

Raise a draft invoice for a job's uninvoiced work. Client, property, line items, tax and payment terms carry over from the job.

Get Invoice

invoice-get

Fetch one invoice by id, with its line items, payment records and the jobs it bills.

List Invoices

invoice-list

List invoices with balances and status. Filter by client, status, or issue and due date windows.

Mark Invoice as Sent

invoice-mark-as-sent

Take an invoice out of draft and record it as sent, which starts its payment terms. Does not email the client.

Create Job from Quote

job-create-from-quote

Convert a quote into a job. Client, property and line items carry over; the scheduling and invoicing terms are set here because Jobber requires them and cannot infer them.

Get Job

job-get

Fetch one job by id, with its line items, visits, originating quote and any invoices raised from it.

List Jobs

job-list

List jobs by Jobber's dashboard bucket, type, scheduling window or assignee. One cursor page per call.

List Products and Services

product-list

List the account's price-book entries with their default unit cost, markup and taxability.

Create Property

property-create

Add a serviced property to a client. Returns the created property with its id.

List Properties

property-list

List serviced properties, optionally narrowed to one client. The source of the `propertyId` that quotes and jobs require.

Approve Quote

quote-approve

Mark a quote approved on the client's behalf. Does not convert it into a job — use Create Job from Quote for that.

Create Quote

quote-create

Create a quote for a client at a property, with at least one line item. Optionally transition it straight to Awaiting response so the client can act on it.

Get Quote

quote-get

Fetch one quote by id, with its line items, totals, and any jobs it was converted into.

List Quotes

quote-list

List quotes with their totals and status. Filter by client, status, salesperson or creation window.

Create Request

request-create

Create a work request against a client — the inbound step a quote is built from. Defaults to the client's most recent property when none is given.

Get Request

request-get

Fetch one work request by id, with its assessment and the quotes and jobs it produced.

List Requests

request-list

List work requests — the inbound form submissions that precede a quote. Filter by client, property, status or assignee.

List Users

user-list

List team members. Defaults to activated users — the ones that can be assigned work. Note `name` and `email` are nested objects.

Complete Visit

visit-complete

Mark a visit complete. Defaults to the current time; set a completion timestamp to backdate it.

Create Visit

visit-create

Schedule a visit on a job. Give a date, time and timezone for a slot; omit the time for an all-day visit, or omit the date entirely for an unscheduled one.

List Visits

visit-list

List scheduled visits, filtered by job, assignee, status or date window. Default sort is start time ascending.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Jobber's real ids.

{
  "manifestVersion": "2",
  "name": "jobber-example",
  "steps": [
    {
      "id": "client-edit",
      "uses": {
        "app": "io.w6w.jobber",
        "action": "client-edit",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "clientId": "<clientId>"
      }
    }
  ]
}

Here are some of the things you can do

  • Edit Client

    perform
    client-edit
  • Get Account

    read
    account-get
  • Create Client

    perform
    client-create
  • Get Client

    read
    client-get
  • List Clients

    search
    client-list

+23 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Jobber, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Jobber. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "client-create",
  payload: {
    // firstName: "<value>",
    // lastName: "<value>",
    // companyName: "<value>",
    // isCompany: "<value>",
    // title: "<value>",
    // email: "<value>",
    // emailDescription: "<value>",
    // phone: "<value>",
    // phoneDescription: "<value>",
    // smsAllowed: "<value>",
    // street1: "<value>",
    // street2: "<value>",
    // city: "<value>",
    // province: "<value>",
    // postalCode: "<value>",
    // country: "<value>",
    // receivesReminders: "<value>",
    // receivesFollowUps: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action client-create --payload '{}'

Give an AI agent Jobber — without giving it Jobber's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.jobber#client-edit",
    "input": {
      "clientId": "<clientId>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Jobber connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Jobber's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Jobber itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Jobber declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Jobber platform status

Atlassian Statuspage rollup for www.jobberstatus.net, with per-component detail (Jobber Online, the API & mobile app, Jobber Payments, messaging, integrations). Unauthenticated and unsigned.

quota

GraphQL query-cost headroom

Points remaining in Jobber's leaky-bucket query-cost budget for this app/account pair, read off `extensions.cost.throttleStatus`. The separate 2500-requests-per-5-minutes DDoS limit is not readable and is not reported.

credential

Get Account