# jobber-mcp

**Model Context Protocol (MCP) server for [Jobber](https://getjobber.com/)** — home service business management software (HVAC, plumbing, landscaping, etc.).

Talk to Jobber from Claude, Cursor, or any MCP client. Read clients, jobs, quotes, invoices; create new clients and add notes. GraphQL API via OAuth2 bearer token.

Built against the [Jobber Developer API](https://developer.getjobber.com/docs/). No existing MCP for Jobber — this is the first.

## What you can do with it

```
You:   "Show me every active job assigned to Alex."
Claude: *list_jobs(status="active") then filters by assignedTo*

You:   "Find every quote awaiting response for over 7 days."
Claude: *list_quotes(status="awaiting_response") then filters by createdAt*

You:   "Add a note to client 12345: 'Replaced capacitor, system running.'"
Claude: *add_client_note with body*

You:   "Create a new client: Sarah Chen, sarah@example.com, 555-0101."
Claude: *create_client*
```

## Install

```bash
pip install -e .
```

## Configure

You need an OAuth2 access token. Get one via the [Jobber OAuth flow](https://developer.getjobber.com/docs/) — register your app, complete the install dance, store the returned token.

```bash
export JOBBER_ACCESS_TOKEN="..."
```

For multi-tenant apps, run multiple MCP server instances — each with its own token. Jobber's tokens expire; you'll need to refresh on your backend and restart the MCP server.

## Use with Claude Desktop

```json
{
  "mcpServers": {
    "jobber_mcp": {
      "command": "jobber_mcp",
      "env": {
        "JOBBER_ACCESS_TOKEN": "..."
      }
    }
  }
}
```

## Tools

| Tool | Type | What it does |
| --- | --- | --- |
| `health_check` | Diagnostic | Verifies token |
| `list_clients` | Read | Homeowners / businesses |
| `list_jobs` | Read | Work orders (filterable by status) |
| `list_quotes` | Read | Quotes (filterable by status) |
| `list_invoices` | Read | Invoices (filterable by status) |
| `create_client` | Write | New client |
| `add_client_note` | Write | Note on client record |

## Why GraphQL, not REST?

Jobber's API is GraphQL-only. The advantage: one HTTP endpoint, ask for exactly the fields you need, no over-fetching, no under-fetching. The MCP tools use minimal field selections so the agent gets the data it needs without pagination churn.

## Development

```bash
pip install -e ".[dev]"
pytest
jobber_mcp
```


---

## Need a custom MCP for your SaaS?

I build production-grade MCP servers for vertical SaaS — insurance, dental, veterinary, legal, property mgmt, home services. Typical engagement: 2-4 weeks, $25K-$120K. Source-owned, MIT-licensed, no vendor lock-in.

See [sanjibani/mcp-services](https://github.com/sanjibani/mcp-services) or email sanjibani@users.noreply.github.com.

---

*Ships in the [sanjibani vertical-MCP portfolio](https://github.com/sanjibani?q=-mcp) — see also [hawksoft-mcp](https://github.com/sanjibani/hawksoft-mcp), [open-dental-mcp](https://github.com/sanjibani/open-dental-mcp), [ezyvet-mcp](https://github.com/sanjibani/ezyvet-mcp), [jobber-mcp](https://github.com/sanjibani/jobber-mcp), [paid-skills](https://github.com/sanjibani/paid-skills), [mcp-vertical-template](https://github.com/sanjibani/mcp-vertical-template).*

---




MIT.

## Acknowledgements

- Jobber for the GraphQL API + OAuth2 flow
- Built using [mcp-vertical-template](https://github.com/sanjibani/mcp-vertical-template) (the GraphQL client is a small variation of the REST template)
- Inspired by [sanjibani/hawksoft-mcp](https://github.com/sanjibani/hawksoft-mcp) and [sanjibani/ezyvet-mcp](https://github.com/sanjibani/ezyvet-mcp)

## See also

- [Jobber API docs](https://developer.getjobber.com/docs/)
- [Jobber Developer Center](https://developer.getjobber.com/)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [More vertical MCPs from sanjibani](https://github.com/sanjibani?q=-mcp)