A comprehensive Model Context Protocol (MCP) server for Jobber, the field service management platform. This server provides tools to interact with jobs, clients, quotes, invoices, scheduling, team management, expenses, products, and reporting.

Features

🔧 Tools (48 total)

Jobs (8 tools)

list_jobs - List all jobs with filtering
get_job - Get job details
create_job - Create a new job
update_job - Update job information
close_job - Mark job as completed
list_job_visits - List visits for a job
create_job_visit - Schedule a visit for a job
list_job_line_items - List job line items

Clients (7 tools)

list_clients - List all clients
get_client - Get client details
create_client - Create a new client
update_client - Update client information
archive_client - Archive a client
search_clients - Search clients by name/email/company
list_client_properties - List client properties

Quotes (8 tools)

list_quotes - List all quotes
get_quote - Get quote details
create_quote - Create a new quote
update_quote - Update quote information
send_quote - Send quote to client
approve_quote - Approve a quote
convert_quote_to_job - Convert approved quote to job
list_quote_line_items - List quote line items

Invoices (7 tools)

list_invoices - List all invoices
get_invoice - Get invoice details
create_invoice - Create a new invoice
send_invoice - Send invoice to client
mark_invoice_paid - Mark invoice as paid
list_invoice_payments - List invoice payments
create_payment - Record a payment

Scheduling (6 tools)

list_visits - List all visits
get_visit - Get visit details
create_visit - Schedule a new visit
update_visit - Update visit information
complete_visit - Mark visit as completed
list_visit_assignments - List assigned users for a visit

Team (4 tools)

list_users - List team members
get_user - Get user details
list_time_entries - List time entries
create_time_entry - Create a time entry

Expenses (5 tools)

list_expenses - List all expenses
get_expense - Get expense details
create_expense - Create a new expense
update_expense - Update expense information
delete_expense - Delete an expense

Products (5 tools)

list_products - List products and services
get_product - Get product/service details
create_product - Create a new product/service
update_product - Update product/service
delete_product - Archive a product/service

Requests (6 tools)

list_requests - List client requests
get_request - Get request details
create_request - Create a new request
update_request - Update request information
convert_request_to_quote - Convert request to quote
convert_request_to_job - Convert request to job

Reporting (3 tools)

get_revenue_report - Revenue analytics
get_job_profit_report - Job profitability analysis
get_team_utilization_report - Team utilization metrics

🎨 MCP Apps (18 total)

job-dashboard - Overview of all jobs with status breakdown
job-detail - Detailed view of a single job
job-grid - Searchable, filterable table of all jobs
client-detail - Detailed view of a single client
client-grid - Searchable table of all clients
quote-builder - Create and edit quotes with line items
quote-grid - List of all quotes with filtering
invoice-dashboard - Overview of invoicing metrics
invoice-detail - Detailed view of a single invoice
schedule-calendar - Calendar view of visits and appointments
team-dashboard - Overview of team members and activity
team-schedule - View schedules for all team members
expense-tracker - Track and manage expenses
product-catalog - Manage products and services
request-inbox - Manage client requests
revenue-dashboard - Revenue reporting and analytics
job-profit-report - Profitability analysis by job
utilization-chart - Team utilization analytics

Installation

npm install
npm run build

Configuration

Set your Jobber API token as an environment variable:

export JOBBER_API_TOKEN=your_api_token_here

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jobber": {
      "command": "node",
      "args": ["/path/to/jobber-server/dist/index.js"],
      "env": {
        "JOBBER_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Standalone

JOBBER_API_TOKEN=your_token node dist/index.js

API

This server uses the Jobber GraphQL API (https://api.getjobber.com/api/graphql) with OAuth2 Bearer token authentication.

Authentication

Get your API token from Jobber:

Log in to your Jobber account
Go to Settings → API → Developer
Create an API token with appropriate permissions

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode for development
npm run dev

Project Structure

jobber/
├── src/
│   ├── clients/
│   │   └── jobber.ts          # GraphQL API client
│   ├── tools/
│   │   ├── jobs-tools.ts      # Job management tools
│   │   ├── clients-tools.ts   # Client management tools
│   │   ├── quotes-tools.ts    # Quote management tools
│   │   ├── invoices-tools.ts  # Invoice management tools
│   │   ├── scheduling-tools.ts # Scheduling tools
│   │   ├── team-tools.ts      # Team management tools
│   │   ├── expenses-tools.ts  # Expense tracking tools
│   │   ├── products-tools.ts  # Product/service catalog tools
│   │   ├── requests-tools.ts  # Client request tools
│   │   └── reporting-tools.ts # Reporting and analytics tools
│   ├── types/
│   │   └── jobber.ts          # TypeScript type definitions
│   ├── ui/
│   │   └── react-app/         # 18 React MCP apps
│   ├── server.ts              # MCP server implementation
│   └── index.ts               # Entry point
├── package.json
├── tsconfig.json
└── README.md

License

MIT

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Support

For issues related to:

This MCP server: Open a GitHub issue
Jobber API: Contact Jobber support
MCP protocol: See https://modelcontextprotocol.io

README.md

Jobber MCP Server