OpsConduit Jobber MCP
Customer-hosted read-only MCP server for Jobber ops reports, OAuth setup, and GraphQL validation.
Que pouvez-vous faire avec 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.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@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>"
}
}
}
}
Variables d'environnement
JOBBER_CLIENT_IDobligatoire Jobber developer app client id for customer-owned OAuth setup.JOBBER_CLIENT_SECRETobligatoire 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
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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.
Questions fréquentes
Qu'est-ce que OpsConduit Jobber MCP ?
Customer-hosted read-only MCP server for Jobber ops reports, OAuth setup, and GraphQL validation.
Comment installer OpsConduit Jobber MCP ?
Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour OpsConduit Jobber MCP ?
Oui. Il attend JOBBER_CLIENT_ID, JOBBER_CLIENT_SECRET, à renseigner dans sa configuration.
OpsConduit Jobber MCP est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient OpsConduit Jobber MCP ?
Il est publié par opsconduit. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.