# io.github.opsconduit/jobber-mcp [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/opsconduit/jobber-mcp  
**GitHub Stars:** 1  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/io-github-opsconduit-jobber-mcp

## Description
Customer-hosted, read-only MCP server for Jobber operations queries: owner action lists, overdue invoices, stale requests, estimates, jobs, and safe read-only GraphQL validation.

## Tools
Capabilities this server exposes over MCP:

- **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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "jobber-mcp": {
    "command": "npx",
    "args": ["-y","opsconduit-jobber-auth"],
    "env": {
      "JOBBER_CLIENT_ID": "",
      "JOBBER_CLIENT_SECRET": ""
    }
  }
}
```

**Requires environment variables:** `JOBBER_CLIENT_ID`, `JOBBER_CLIENT_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & 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](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/index.md).
Common buyer questions are answered in [docs/faq.md](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/faq.md).
Example owner/operator prompts are in [docs/operator-prompts.md](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/operator-prompts.md).
First paid-install deliverable shape: [docs/first-report.md](https://github.com/opsconduit/jobber-mcp/blob/HEAD/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](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/use-cases.md).

A fictional sample output is available in [docs/demo-output.md](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/demo-output.md), or run:

```bash
npm run demo
```

The paid pilot handoff format is documented in [docs/pilot-deliverable-template.md](https://github.com/opsconduit/jobber-mcp/blob/HEAD/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](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/offer.md).

For pilot setup, email `opsconduit@gmail.com` with the subject `Jobber pilot`. Do not send Jobber passwords, tokens, API secrets, or private customer data by email.

## Install

Requires Node.js 20+.

```bash
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](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/install.md). Paid pilot validation steps are in [docs/pilot-checklist.md](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/pilot-checklist.md).
Implementation notes for Jobber's GraphQL API are in [docs/jobber-api-notes.md](https://github.com/opsconduit/jobber-mcp/blob/HEAD/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

- [Terms of Service](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/terms.md)
- [Privacy Policy](https://github.com/opsconduit/jobber-mcp/blob/HEAD/docs/privacy.md)

## 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.