Workever MCP server Let your AI agent run the Workever office.

ToolWhat it doesAccess

• list_customers Customers and sites, searchable by name or postcode. read

  Returns customers with ID, sites, open jobs and balance.

  MCP callworkever_read → list_customers

  REST endpointGET https://cotlet.dev/api/v1/workever/customers

  Parameters

  Parameters: list_customers

  Name	Type	Description
  query string	string	Name or postcode.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "customers": [
      {
        "customer_id": "WC-2210",
        "name": "Sophie Hargreaves",
        "site": "18 Burton Rd, Manchester",
        "open_jobs": 1
      }
    ],
    "page": 1
  }

• list_jobs Jobs by date, fieldworker or status. read

  Returns jobs with customer, site, fieldworker, time and status.

  MCP callworkever_read → list_jobs

  REST endpointGET https://cotlet.dev/api/v1/workever/jobs

  Parameters

  Parameters: list_jobs

  Name	Type	Description
  date_from string	string	ISO date.
  date_to string	string	ISO date.
  status string	string	Unscheduled, Scheduled, Completed.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "jobs": [
      {
        "job_id": "WJ-5512",
        "customer": "Sophie Hargreaves",
        "title": "EICR",
        "fieldworker": "Tom",
        "start": "2026-11-10T09:00",
        "status": "Scheduled"
      }
    ]
  }

• create_job Creates a job for a customer site, unscheduled. write

  Adds the job with title and description. Reaches no one, so it runs at once.

  MCP callworkever_write → create_job

  REST endpointPOST https://cotlet.dev/api/v1/workever/customers/{customer_id}/jobs

  Parameters

  Parameters: create_job

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  title string required	string	Job title.
  description string	string	Details.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "title": "title"
  }

  Example response

  {
    "job_id": "WJ-5560",
    "customer": "Aisha Rahman",
    "title": "Socket not working",
    "status": "Unscheduled"
  }

ToolWhat it doesAccess

• schedule_job Schedules a job with a fieldworker. writeasks first

  Puts the job in the schedule; the fieldworker gets it in the app and your settings decide whether the customer is told. By default you confirm each call; you can switch that off for this tool.

  MCP callworkever_write → schedule_job

  REST endpointPOST https://cotlet.dev/api/v1/workever/jobs/{job_id}/schedule

  Parameters

  Parameters: schedule_job

  Name	Type	Description
  job_id string required	string	Job ID from list_jobs.
  fieldworker string required	string	Fieldworker name.
  start string required	string	ISO date and time.

  Example input

  {
    "job_id": "WJ-5560",
    "fieldworker": "Tom",
    "start": "2026-11-11T14:00"
  }

  Example response

  {
    "job_id": "WJ-5560",
    "fieldworker": "Tom",
    "start": "2026-11-11T14:00",
    "status": "Scheduled"
  }

ToolWhat it doesAccess

• create_quote Drafts a quote with lines and VAT. write

  Creates the quote for the customer; sending it stays in Workever. Reaches no one, so it runs at once.

  MCP callworkever_write → create_quote

  REST endpointPOST https://cotlet.dev/api/v1/workever/customers/{customer_id}/quotes

  Parameters

  Parameters: create_quote

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  items array required	array	Description, quantity, price, VAT rate.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "items": "items"
  }

  Example response

  {
    "quote_id": "WQ-1180",
    "customer": "Aisha Rahman",
    "total": "540.00",
    "status": "Draft"
  }

• list_unpaid_invoices Invoices not yet paid, oldest first. read

  Returns unpaid invoices with customer, total and days overdue.

  MCP callworkever_read → list_unpaid_invoices

  REST endpointGET https://cotlet.dev/api/v1/workever/unpaid-invoices

  Parameters

  Parameters: list_unpaid_invoices

  Name	Type	Description
  min_days_overdue integer	integer	Only invoices overdue at least this many days.

  Example response

  {
    "invoices": [
      {
        "invoice_id": "WI-3021",
        "customer": "Sophie Hargreaves",
        "total": "186.00",
        "days_overdue": 12
      }
    ]
  }