jobber-mcp is a read-only MCP connector provided by OpsConduit for Jobber field service operations. It is designed to help owners and operators ask practical questions about the tools that run their business. The first connector targets Jobber and is read-only by default.
Purpose: This tool mainly answers operational questions, such as: Which quotes need follow-up? Which invoices are overdue? Which jobs are unscheduled, stalled, or blocked? Which clients have had no recent activity? Which jobs need attention this week? Where is operational follow-up causing revenue leakage? More buyer-facing examples are in docs/use-cases.md.
Main capabilities: Provides a set of MCP tools, including: jobber_auth_url (creates a one-time Jobber OAuth authorization link for customer self-hosted installation), jobber_exchange_code (exchanges the redirected OAuth code and stores the token locally, without exposing it in chat), jobber_refresh_token (refreshes the stored access token to continue read-only reporting), jobber_account (verifies the connected account before running operational queries), jobber_clients_sample (verifies read access through a capped client sample), jobber_graphql_read (runs read-only Jobber GraphQL to generate owner reports; mutation operations are blocked before sending).
Usage: Requires Node.js 20+. Before running the authentication helper, fill in JOBBER_CLIENT_ID and JOBBER_CLIENT_SECRET in .env. The helper prints a Jobber OAuth URL, receives a local callback http://localhost:3333/oauth/callback，并将令牌存储在 .opsconduit/jobber-tokens.json. Detailed installation instructions are in docs/install.md, paid pilot verification steps are in docs/pilot-checklist.md, and implementation notes for the Jobber GraphQL API are in docs/jobber-api-notes.md. The paid pilot handoff format is documented in docs/pilot-deliverable-template.md.
Use cases: For owners and operators of Jobber field service operations, used to generate read-only operational reports, discover quotes that need follow-up, overdue invoices, unscheduled or stalled jobs, clients with no recent activity, and jobs that need attention this week. Suitable for teams that want to run customer self-hosted, stay read-only, not host credentials, and not automatically write into customer systems.
Limitations: This repository is in an early implementation stage. The first usable target is a customer self-hosted MCP server with local OAuth setup and read-only Jobber GraphQL access. The product stance includes: customer self-hosted first, read-only first, no credential hosting in the public repository, no automatic writing into customer systems, no scraping of private data, and no false claims or deceptive promotion. Early access pricing is documented in docs/offer.md. For pilot setup, email opsconduit@gmail.com with the subject Jobber pilot. Do not send Jobber passwords, tokens, API keys, or private customer data by email.