mcpField
O
OpsConduit Jobber MCP

OpsConduit Jobber MCP

Local
github.com/opsconduitBusiness & Marketing1Updated 23w ago
Repository

About OpsConduit Jobber MCP

OpsConduit Jobber MCP is a customer-hosted, read-only connector for Jobber field-service operations. It supports local OAuth setup and GraphQL-based reporting to help owners and operators identify follow-ups and work needing attention; the project is in early implementation.

Key features

  1. 01Set up Jobber OAuth locally
  2. 02Refresh and store tokens locally
  3. 03Validate the connected account
  4. 04Sample client data for read-access checks
  5. 05Run read-only Jobber GraphQL queries
  6. 06Block mutations before submission

Use cases

  1. 01Find estimates that need follow-up
  2. 02Review overdue invoices and unscheduled jobs
  3. 03Identify customers without recent activity
  4. 04Prepare weekly operational attention reports

MCP support

The MCP server exposes tools for Jobber OAuth, account validation, sample client reads, and read-only GraphQL reporting. Mutations are blocked before being sent.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "opsconduit-jobber": {
      "command": "npx",
      "args": [
        "-y",
        "@opsconduit/jobber-mcp"
      ],
      "env": {
        "JOBBER_CLIENT_ID": "<JOBBER_CLIENT_ID>",
        "JOBBER_CLIENT_SECRET": "<JOBBER_CLIENT_SECRET>",
        "JOBBER_REDIRECT_URI": "<JOBBER_REDIRECT_URI>"
      }
    }
  }
}
Run commandnpx -y @opsconduit/jobber-mcp
Environment variables to set
JOBBER_CLIENT_IDJobber developer app client id for customer-owned OAuth setup.
JOBBER_CLIENT_SECRETSecretJobber developer app client secret. Keep local; do not email or publish.
JOBBER_REDIRECT_URIOAuth redirect URI, usually http://localhost:3333/oauth/callback for local setup.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@opsconduit/jobber-mcp0.1.3

Tools

6

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
statestringNoOpaque CSRF/state token to verify when Jobber redirects back. If omitted, OpsConduit generates one.
redirectUristringNoOAuth callback URL configured in the Jobber developer app, for example http://localhost:3333/oauth/callback.

Details

From the project README

OpsConduit Jobber MCP

Read-only MCP connector for Jobber field-service operations.

OpsConduit helps owners and operators ask practical questions about the tools that run their business. This first connector is for Jobber and is designed to stay read-only by default.

Plain buyer-facing overview: docs/index.md. Common buyer questions are answered in docs/faq.md. Example owner/operator prompts are in docs/operator-prompts.md. First paid-install deliverable shape: docs/first-report.md.

What It Should Answer

  • Which estimates need follow-up?
  • Which invoices are overdue?
  • Which jobs are unscheduled, stale, or blocked?
  • Which customers have not had activity recently?
  • What work needs attention this week?
  • Where is operational follow-up leaking revenue?

More buyer-facing examples are in docs/use-cases.md.

A fictional sample output is available in docs/demo-output.md, or run:

npm run demo

The paid pilot handoff format is documented in docs/pilot-deliverable-template.md.

Product Posture

  • Customer-hosted first.
  • Read-only first.
  • No credential custody required for the public repo.
  • No autonomous writes in customer systems.
  • No scraping private data.
  • No fake claims, fake testimonials, or deceptive outreach.

Launch Offer

Early-access pricing is documented in docs/offer.md.

For pilot setup, email [email protected] with the subject Jobber pilot. Do not send Jobber passwords, tokens, API secrets, or private customer data by email.

Install

Requires Node.js 20+.

mkdir opsconduit-jobber
cd opsconduit-jobber
npm install @opsconduit/jobber-mcp
cp node_modules/@opsconduit/jobber-mcp/.env.example .env
npx opsconduit-jobber-auth
npx opsconduit-jobber-mcp

Fill JOBBER_CLIENT_ID and JOBBER_CLIENT_SECRET in .env before running the auth helper. The helper prints a Jobber OAuth URL, receives the local callback at http://localhost:3333/oauth/callback, and stores tokens in .opsconduit/jobber-tokens.json.

Detailed setup notes are in docs/install.md. Paid pilot validation steps are in docs/pilot-checklist.md. Implementation notes for Jobber's GraphQL API are in docs/jobber-api-notes.md.

MCP Tools

  • jobber_auth_url - create the one-time Jobber OAuth authorization link for a customer-hosted install.
  • jobber_exchange_code - exchange the redirected OAuth code and store tokens locally without exposing them in chat.
  • jobber_refresh_token - refresh the stored access token for continued read-only reporting.
  • jobber_account - validate the connected account before running operational queries.
  • jobber_clients_sample - validate read access with a capped client sample.
  • jobber_graphql_read - run read-only Jobber GraphQL for owner reports; mutations are blocked before sending.

Policies

Status

This repository is in early implementation. The first usable target is a customer-hosted MCP server with local OAuth setup and read-only Jobber GraphQL access.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.