OpsConduit Jobber MCP
Customer-hosted read-only MCP server for Jobber ops reports, OAuth setup, and GraphQL validation.
What can you do with OpsConduit Jobber 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.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@opsconduit/jobber-mcpclaude mcp add opsconduit-jobber-mcp -e 'JOBBER_CLIENT_ID=<JOBBER_CLIENT_ID>' -e 'JOBBER_CLIENT_SECRET=<your jobber_client_secret>' -e 'JOBBER_REDIRECT_URI=<JOBBER_REDIRECT_URI>' -- npx -y @opsconduit/jobber-mcp@0.1.3
{
"mcpServers": {
"opsconduit-jobber-mcp": {
"command": "npx",
"args": [
"-y",
"@opsconduit/jobber-mcp@0.1.3"
],
"env": {
"JOBBER_CLIENT_ID": "<JOBBER_CLIENT_ID>",
"JOBBER_CLIENT_SECRET": "<your jobber_client_secret>",
"JOBBER_REDIRECT_URI": "<JOBBER_REDIRECT_URI>"
}
}
}
}
Environment variables
JOBBER_CLIENT_IDrequired Jobber developer app client id for customer-owned OAuth setup.JOBBER_CLIENT_SECRETrequired secret Jobber 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.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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 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+.
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.
Frequently asked questions
What is OpsConduit Jobber MCP?
Customer-hosted read-only MCP server for Jobber ops reports, OAuth setup, and GraphQL validation.
How do I install OpsConduit Jobber MCP?
It runs on your machine. In Claude Code: claude mcp add opsconduit-jobber-mcp -e 'JOBBER_CLIENT_ID=<JOBBER_CLIENT_ID>' -e 'JOBBER_CLIENT_SECRET=<your jobber_client_secret>' -e 'JOBBER_REDIRECT_URI=<JOBBER_REDIRECT_URI>' -- npx -y @opsconduit/jobber-mcp@0.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.
Does OpsConduit Jobber MCP need an API key?
Yes. It expects JOBBER_CLIENT_ID, JOBBER_CLIENT_SECRET, which you set in its configuration.
Is OpsConduit Jobber MCP open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains OpsConduit Jobber MCP?
It is published by opsconduit. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.