Jake Shore 63a1ca0df6 jobber: Complete MCP server with 97 tools and 15 React apps

- Added 97 tools across 15 domains (jobs, clients, quotes, invoices, scheduling, team, expenses, products, requests, reporting, properties, timesheets, line-items, forms, taxes)
- Created 15 React apps with dark theme (job-board, job-detail, client-dashboard, client-detail, quote-builder, invoice-dashboard, schedule-calendar, visit-tracker, expense-manager, timesheet-grid, request-inbox, form-builder, property-map, financial-dashboard, team-overview)
- Each app includes App.tsx, index.html, main.tsx, vite.config.ts
- Updated tsconfig.json with jsx: react-jsx
- Created main.ts entry point
- Updated server.ts to include all tool domains
- Comprehensive README with full documentation
- TypeScript compilation passes cleanly

2026-02-12 17:49:10 -05:00

4.4 KiB

Raw Blame History

Jobber MCP Server

A comprehensive Model Context Protocol (MCP) server for Jobber field service management platform.

Features

50+ Tools Across Multiple Domains

Jobs (8 tools): List, get, create, update, close jobs, manage visits and line items
Clients (7 tools): Full CRUD for clients, search, archiving
Quotes (9 tools): Create, send, approve, convert quotes
Invoices (10 tools): Create, send, track payments, manage invoice lifecycle
Scheduling (7 tools): Create, update, complete visits, assign team members
Team (6 tools): Manage users, track time entries, team assignments
Expenses (5 tools): Track job expenses, categories, receipts
Products (5 tools): Product/service catalog management
Requests (5 tools): Customer request inbox and conversion
Reporting (4 tools): Revenue, job profitability, utilization metrics
Properties (6 tools): Manage client properties and service locations
Timesheets (7 tools): Time tracking, timesheet summaries
Line Items (8 tools): Manage line items across jobs, quotes, invoices
Forms (8 tools): Custom form builder and submissions
Taxes (8 tools): Tax rates, calculations, line item tax management

Total: 103 tools

15 React Applications

Modern, dark-themed React apps for data visualization and management:

Job Board - Browse and filter all jobs
Job Detail - Comprehensive job view with visits and line items
Client Dashboard - Client overview with revenue metrics
Client Detail - Individual client profile and job history
Quote Builder - Interactive quote creation interface
Invoice Dashboard - Track invoices and payment status
Schedule Calendar - Visual scheduling interface
Visit Tracker - Field visit management
Expense Manager - Business expense tracking
Timesheet Grid - Team time entry tracking
Request Inbox - Customer inquiry management
Form Builder - Custom form designer
Property Map - Service location visualization
Financial Dashboard - Revenue, expenses, profitability
Team Overview - Team member management and metrics

Each app includes:

App.tsx - Main React component
index.html - HTML entry point
main.tsx - React bootstrap
vite.config.ts - Vite configuration

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

As MCP Server

Add to your MCP settings file:

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

Running React Apps

Each React app can be run independently:

cd src/ui/react-app/src/apps/job-board
npm install
npm run dev

Apps are configured to run on ports 3000-3014.

API Integration

This server integrates with the Jobber GraphQL API. All tools use GraphQL queries and mutations with proper error handling and pagination support.

Development

# Watch mode for development
npm run dev

# Type checking
npx tsc --noEmit

# Build
npm run build

Architecture

Client: GraphQL client with query builder and pagination helpers
Types: Comprehensive TypeScript types for all Jobber entities
Tools: Organized by domain, each with Zod input validation
Server: MCP server implementation with tool registration
UI: React apps with Tailwind CSS dark theme

Tools Highlights

Job Management

Create and update jobs with client and property assignments
Track job status (Active, Completed, Late, etc.)
Manage visits and schedule field work
Add line items and calculate totals

Client Management

Full client CRUD operations
Property management for service locations
Client search and filtering
Archive/unarchive capabilities

Financial Operations

Quote creation and approval workflow
Invoice generation and payment tracking
Expense management
Tax calculation and application
Revenue and profitability reporting

Scheduling & Time Tracking

Visit creation and assignment
Team member scheduling
Time entry tracking
Timesheet summaries

Custom Forms

Build custom forms for field data collection
Form submission tracking
Link forms to jobs and visits

License

MIT

Author

MCPEngine

4.4 KiB Raw Blame History