Jobber Automation MCP
Jobber Automation MCP
Un servidor MCP autoalojado que permite a ChatGPT inspeccionar datos de Jobber y gestionar automatizaciones controladas. El mismo stack de Docker Compose se ejecuta en macOS, Linux y Raspberry Pi ARM64.
Esta es una versión inicial de un solo propietario. No está diseñada para alojamiento público o multitenant.
Versión actual: v0.2.1
Arquitectura
flowchart LR
C[ChatGPT] --> T[Secure MCP Tunnel]
T --> M[Jobber Automation MCP]
M --> J[Jobber GraphQL API]
M --> D[(Private SQLite data)]
M --> W[Automation worker]El servidor MCP define las herramientas que ChatGPT puede invocar. El worker ejecuta las programaciones guardadas incluso cuando no hay ningún chat abierto. El catálogo de acciones está controlado intencionadamente; las definiciones de automatización no pueden ejecutar comandos arbitrarios del sistema operativo.
Related MCP server: Jobber MCP Connector
Capacidades actuales
Flujo de código de autorización OAuth de Jobber y soporte de tokens de actualización rotatorios
Consultas de cuenta, cliente y trabajo de Jobber
GraphQL de solo lectura y vías de escape de mutación explícitamente confirmadas
Persistencia SQLite con modo WAL y un archivo de base de datos privado
Herramientas de automatización: create, list, get, update, activate, pause, preview, run-now, history y delete
Disparadores manuales y de intervalo repetido
Acciones de Log, consulta de Jobber y mutación de Jobber
Ciclo de revisión de borrador al crear y borrador después de editar
Políticas de automatización con aprobación por ejecución o preaprobadas explícitamente
Planificador en segundo plano con historial de ejecución y auditoría
Empaquetado Docker compatible con el desarrollo en macOS y los hosts Raspberry Pi con Linux ARM64
Comportamiento de seguridad
Las automatizaciones nuevas y editadas son borradores y no pueden ejecutarse.
La activación requiere la frase exacta
I APPROVE THIS AUTOMATION.Una automatización de mutación de Jobber que use la aprobación
alwaysno puede mutar desde el planificador.Su ejecución manual requiere
I CONFIRM THIS AUTOMATION RUN.Una automatización de mutación
preapprovedsolo puede ejecutarse sin supervisión después de que su definición completa sea revisada y activada.Las mutaciones genéricas puntuales requieren confirmación explícita del usuario. Las confirmaciones aceptadas incluyen
I CONFIRM THIS JOBBER CHANGE,I confirm,confirmed,yes,yes, do it,do it,approvedeI approve(sin distinción de mayúsculas y minúsculas y con espacios recortados).El estado de OAuth se procesa con hash, es de un solo uso y caduca a los diez minutos.
Cada intento de mutación y cada resultado de automatización se auditan.
Instalación
Empieza con la documentación que coincida con la tarea:
La configuración rápida de desarrollo local requiere Node.js 22.5 o superior:
npm install
npm run build
npm startLa base de datos utiliza por defecto ./data/jobber-mcp.sqlite.
Endpoint MCP de ChatGPT
La ruta MCP local es:
http://localhost:8080/mcp/YOUR_MCP_PATH_TOKENEl archivo Compose incluido ejecuta el OpenAI Secure MCP Tunnel junto con el servidor. Ambos puertos publicados se vinculan únicamente al loopback del host; no los expongas mediante el reenvío de puertos del router.
Ejemplo de definición de automatización
{
"name": "Hourly account check",
"description": "Verify that Jobber remains reachable.",
"approvalPolicy": "always",
"trigger": { "type": "interval", "everyMinutes": 60 },
"actions": [
{
"type": "jobber.query",
"query": "query Account { account { id name } }"
}
]
}La herramienta MCP crea esto como borrador. Previsualízalo, actívalo y luego inspecciona su historial.
Desarrollo
npm run checkEl conjunto de pruebas cubre la separación de operaciones GraphQL y el ciclo de vida local de las automatizaciones.
Política de lanzamientos
Las versiones usan Versionado Semántico MAJOR.MINOR.PATCH. Cada lanzamiento recibe una etiqueta Git y una entrada de changelog correspondiente. Hasta v1.0, las versiones menores pueden incluir cambios sustanciales que requieren revisar las notas de migración.
Trabajo planificado
Herramientas Jobber con nombre basadas en el esquema autenticado en lugar de GraphQL genérico
Disparadores de calendario/cron, sondeo de Jobber y retransmisión webhook
Condiciones, plantillas, notificaciones, reintentos y claves de idempotencia
Panel de automatización integrado de MCP Apps
Almacenamiento de tokens cifrado o respaldado por el sistema operativo
Verificación automatizada de copias de seguridad y comandos de restauración más simples
Flujos de trabajo de programación y gestión de visitas diseñados específicamente
Limitaciones importantes
El trabajo programado se ejecuta solo mientras el host está encendido y el servidor está en ejecución.
Un Secure MCP Tunnel conecta ChatGPT con MCP; no es un endpoint webhook entrante general de Jobber.
Los campos y las mutaciones de Jobber deben verificarse contra el esquema autenticado y la versión de API seleccionada antes de usarlos en producción.
No expongas el puerto local directamente a Internet pública.
Licencia
Publicado bajo la Licencia MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect ChatGPT and Claude to Fortnox: invoices, customers, reports. Every write needs your OK.
Jobber MCP server for ChatGPT, Claude and any AI agent: create quote, convert quote to job, create invoice, send invoice and list unpaid invoices in your own Jobber account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Jobber yourself; Cotlet does not store your password and you need no Jobber API key. About the official Jobber API: Yes, Jobber has a GraphQL API in its Developer Center (checked 14 Oct 2026), but you cannot use it without registering an app. Each Jobber account authorizes your app with OAuth 2.0 and tokens must be refreshed. Setup and FAQ: https://cotlet.dev/integrations/jobber-api-mcp-server
Job management for service companies: look up, book, tag, assign and note jobs from your AI.
Run a home-service business from your AI: jobs, customers, invoices, estimates, texts.
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables AI assistants to access and manage Jobber field-service data including clients, jobs, invoices, and quotes through natural language interactions.661 npmMIT
- AlicenseAqualityFmaintenanceConnects Claude to Jobber to manage clients, jobs, invoices, quotes, and scheduling through natural language.10MIT
- AlicenseAqualityDmaintenanceConnect an AI assistant to your Jobber account to query clients, jobs, invoices, and more in plain English, with optional write actions for creating clients and jobs.12MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants like Claude, ChatGPT, and Copilot to query live Jobber data—clients, jobs, quotes, invoices, revenue, and schedule—using natural language, with read-only access and careful API budget management.1MIT