Jobber MCP Connector

A Model Context Protocol (MCP) server that connects Claude to Jobber — the field service management platform. Manage clients, jobs, invoices, quotes, and scheduling through natural language.

Built by Total Property Solutions Pro.

What You Can Do

Once connected, you can ask Claude things like:

• "Show me all active jobs this week"

• "Create a client for John Smith at 123 Main St"

• "What's on the schedule for tomorrow?"

• "Create a quote for roof cleaning at $350 for the Johnsons"

• "Mark job #142 as completed"

• "List all unpaid invoices"

• "Create an invoice for job #142 due in 30 days"

Related MCP server: Motion MCP Server

Tools Available

Prerequisites

• Node.js v18 or later

• A Jobber account

• A Jobber Developer App (free — see setup below)

• Claude Desktop or another MCP-compatible client

Installation

git clone https://github.com/totalproperty/jobber-mcp-connector.git
cd jobber-mcp-connector
npm install

Configuration

Step 1 — Create a Jobber Developer App

1. Go to developer.getjobber.com and sign in

2. Click Create App

3. Set the Redirect URI to http://localhost:3100/callback

4. Copy your Client ID and Client Secret

Step 2 — Set Up Environment Variables

cp .env.example .env

Edit .env with your credentials:

JOBBER_CLIENT_ID=your_client_id_here
JOBBER_CLIENT_SECRET=your_client_secret_here

Step 3 — Authorize via OAuth2

Run the included helper to get your access and refresh tokens:

JOBBER_CLIENT_ID=your_id JOBBER_CLIENT_SECRET=your_secret node src/oauth-helper.js

This will:

1. Print an authorization URL — open it in your browser

2. After you approve the app in Jobber, it captures the callback automatically

3. Print your JOBBER_ACCESS_TOKEN and JOBBER_REFRESH_TOKEN

Add both tokens to your .env file.

Step 4 — Configure Claude Desktop

Add this to your Claude Desktop MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "jobber": {
      "command": "node",
      "args": ["/absolute/path/to/jobber-mcp-connector/src/index.js"],
      "env": {
        "JOBBER_CLIENT_ID": "your_client_id",
        "JOBBER_CLIENT_SECRET": "your_client_secret",
        "JOBBER_ACCESS_TOKEN": "your_access_token",
        "JOBBER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Restart Claude Desktop. The Jobber tools will appear automatically.

Usage Examples

List today's schedule

"What's on my schedule today?"

Create a client

"Add a new client: Sarah Johnson, sarah@email.com, (555) 867-5309, 456 Oak Ave, Tampa FL 33601"

Create a quote

"Create a quote for Sarah Johnson for pressure washing her driveway — 2 hours at $95/hr"

Check unpaid invoices

"Show me all invoices that haven't been paid yet"

Update job status

"Mark job #204 as completed"

Token Refresh

Access tokens expire periodically. The connector automatically refreshes them using your JOBBER_REFRESH_TOKEN. If you see authentication errors, re-run the OAuth helper to get fresh tokens.

Development

# Run with auto-reload on file changes
npm run dev

# Run normally
npm start

Project Structure

jobber-mcp-connector/
├── src/
│   ├── index.js          # MCP server entry point
│   ├── jobber-client.js  # GraphQL API client + OAuth2
│   ├── queries.js        # All GraphQL queries and mutations
│   ├── tools.js          # Tool definitions and handlers
│   └── oauth-helper.js   # One-time OAuth2 authorization helper
├── .env.example          # Environment variable template
├── package.json
└── README.md

License

MIT — Built by Total Property Solutions Pro