← Back to Skills Marketplace
byungkyu

jobber

by byungkyu · GitHub ↗ · v1.2.6 · MIT-0
cross-platform ✓ Security Clean
7070
Downloads
3
Stars
0
Active Installs
12
Versions
Install in OpenClaw
/install jobber
Description
Jobber API integration with managed OAuth. Manage clients, jobs, invoices, quotes, properties, and team members for field service businesses. Use this skill when users want to create and manage service jobs, clients, quotes, invoices, or access scheduling data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key. Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Jobber connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Jobber action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Jobber examples; they add no Jobber capability - Jobber is not an event source, a trigger cannot read Jobber data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe).
Usage Guidance
Install only if you intend to use Maton to access a Jobber account and possibly create user-approved automations. Review every write, function deploy, trigger, or destination carefully, especially anything involving invoices, customer data, persistent forwarding, or API keys.
Capability Assessment
ℹ Credentials
Network access and Maton authentication are necessary for the stated integration. The raw HTTP/API-key fallback is sensitive but explicitly limited to environments without the CLI and includes clear secret-handling guidance.
✓ Install Mechanism
Installation is limited to pinned Maton CLI options via npm or Homebrew, plus optional pinned SDK packages. No executable scripts are shipped in the skill bundle.
ℹ Instruction Scope
The instructions repeatedly require read/list defaults, explicit approval for connection creation, writes, deletes, function deployment, invocation, trigger destinations, and local --exec use. The Jobber webhook note could confuse users because the skill also says Jobber is not a Maton event source, but the artifact does not instruct automatic Jobber webhook setup.
ℹ Persistence & Privilege
The skill involves persistent OAuth credentials, hosted functions, triggers, and destination forwarding, but these are disclosed and repeatedly require user confirmation, least-privilege review, and deletion when no longer needed.
ℹ Purpose & Capability
The Jobber API purpose matches the documented capabilities: listing and managing clients, jobs, invoices, quotes, properties, requests, and users through Maton-authenticated calls. Hosted functions, triggers, and destinations are broader Maton automation capabilities, but the artifact explains why they are included and frames them as user-approved automation rather than default behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install jobber
  3. After installation, invoke the skill by name or use /jobber
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.6
Simplify the login instructions to the code flow (maton login prints a link; finish with maton login --code <CODE>), drop the API Key subsection, and pin the Maton CLI install to 0.4.0.
v1.2.5
- Updated the API version to the latest
v1.2.4
Switch the login instructions to the device flow (maton login prints a link and a user code; the --oauth flag is gone) and pin the Maton CLI install to 0.3.5.
v1.2.3
Pin the Maton CLI install to 0.3.4, the current release.
v1.2.2
Add this skill's own trigger policy to the shared Triggers section: the only destination it sets up is its own hosted function inside the platform, it does not forward events to third-party hosts, and it does not use event watch --exec; each trigger reference now also says this skill configures no trigger from that source on its own.
v1.2.1
Bring the skill to the current api-gateway baseline and tell the connection-to-function-to-trigger story: the shared Functions and Triggers sections open with an example for this app (a hosted function that performs one action for it through the Maton SDK, and the trigger that runs it - its own event source where it has one, otherwise a time schedule), the description says these constructs turn the connection into automation and add no capability of their own, the passthrough is described by its enforced boundary, CLI and SDK installs are pinned to 0.3.1, absolute API URLs are placeholders, and multipart uploads use mktemp.
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.3
- Changed all API and connection URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai for consistency and future-proofing. - Updated connection management instructions and example code to reference the new api.maton.ai endpoints. - Clarified header usage when specifying connections. - Added a section about security, permissions, and explicit user approval for write operations. - Removed the LICENSE.txt file.
v1.0.2
- Added clawdbot metadata to the skill definition. - Declared the MATON_API_KEY environment variable as a requirement for the skill.
v1.0.1
- No code or documentation changes detected in this version. - Version number incremented to 1.0.1.
v1.0.0
Initial release of the Jobber skill providing managed OAuth integration for field service business operations: - Integrates with the Jobber API via a managed OAuth gateway - Enables management of clients, jobs, invoices, quotes, properties, and team members - Provides quick start examples and authentication setup using a Maton API key - Supports connection management (list, create, get, delete, specify connection) - Includes detailed GraphQL API reference and sample queries for core Jobber resources
Metadata
Slug jobber
Version 1.2.6
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 12
Frequently Asked Questions

What is jobber?

Jobber API integration with managed OAuth. Manage clients, jobs, invoices, quotes, properties, and team members for field service businesses. Use this skill when users want to create and manage service jobs, clients, quotes, invoices, or access scheduling data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key. Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Jobber connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Jobber action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Jobber examples; they add no Jobber capability - Jobber is not an event source, a trigger cannot read Jobber data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe). It is an AI Agent Skill for Claude Code / OpenClaw, with 7070 downloads so far.

How do I install jobber?

Run "/install jobber" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is jobber free?

Yes, jobber is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does jobber support?

jobber is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created jobber?

It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.6.

💬 Comments