Powered Now MCP server Let your AI agent run the Powered Now office.

ToolWhat it doesAccess

• list_customers Customers, searchable by name, postcode or phone. read

  Returns customers with ID, sites, phone and open quotes or unpaid invoices.

  MCP callpowered_now_read → list_customers

  REST endpointGET https://cotlet.dev/api/v1/powered-now/customers

  Parameters

  Parameters: list_customers

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

  Example response

  {
    "customers": [
      {
        "customer_id": "PN-11872",
        "name": "Mrs Joanne Whitcombe",
        "postcode": "LS6 2AB",
        "open_quotes": 1,
        "unpaid": "0.00"
      }
    ],
    "page": 1
  }

• add_customer Adds a customer with a site address. write

  Creates the customer and site. Search list_customers first so a returning customer does not become a duplicate. Reaches no one, so it runs at once.

  MCP callpowered_now_write → add_customer

  REST endpointPOST https://cotlet.dev/api/v1/powered-now/customers

  Parameters

  Parameters: add_customer

  Name	Type	Description
  name string required	string	Customer name.
  address string required	string	Site address.
  phone string	string	Phone.
  email string	string	Email.

  Example input

  {
    "name": "Jane Doe",
    "address": "address"
  }

  Example response

  {
    "customer_id": "PN-11930",
    "name": "Mr Dev Patel",
    "site": "14 Gloucester Rd, Bristol"
  }

ToolWhat it doesAccess

• create_quote Drafts a quote with line items and VAT. write

  Builds the quote from your price list or free lines, with VAT. Sending it is a separate step, so drafting runs at once.

  MCP callpowered_now_write → create_quote

  REST endpointPOST https://cotlet.dev/api/v1/powered-now/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 or price list item, quantity, price, VAT rate.

  Example input

  {
    "customer_id": "PN-11930",
    "items": [
      {
        "description": "Consumer unit replacement",
        "quantity": 1,
        "price": "1,450.00",
        "vat": 20
      },
      {
        "description": "Extra double socket",
        "quantity": 6,
        "price": "66.67",
        "vat": 20
      }
    ]
  }

  Example response

  {
    "quote_id": "Q-2041",
    "customer": "Mr Dev Patel",
    "net": "1,850.00",
    "vat": "370.00",
    "total": "2,220.00",
    "status": "Draft"
  }

• convert_to_invoice Turns an accepted quote into an invoice draft. write

  Converts the quote the way Powered Now does, in full or as a deposit or stage. Sending it is a separate step.

  MCP callpowered_now_write → convert_to_invoice

  REST endpointPOST https://cotlet.dev/api/v1/powered-now/quotes/{quote_id}/invoice/convert

  Parameters

  Parameters: convert_to_invoice

  Name	Type	Description
  quote_id string required	string	Quote ID.
  percent number	number	Share to invoice now, for a deposit. Default: 100.

  Example input

  {
    "quote_id": "quote_8c41d2"
  }

  Example response

  {
    "invoice_id": "INV-3318",
    "from_quote": "Q-2041",
    "total": "2,220.00",
    "status": "Draft"
  }

• send_document Sends a quote or invoice by email or text. writeasks first

  Sends the document with its link, the way Send does in Powered Now. By default you confirm each call; you can switch that off for this tool.

  MCP callpowered_now_write → send_document

  REST endpointPOST https://cotlet.dev/api/v1/powered-now/documents/{document_id}

  Parameters

  Parameters: send_document

  Name	Type	Description
  document_id string required	string	Quote or invoice ID.
  via string	string	email or text. Default: email.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document": "INV-3318",
    "status": "Sent",
    "via": "email"
  }

• list_unpaid_invoices Sent invoices with a balance, oldest first. read

  Returns unpaid invoices with customer, balance and days overdue.

  MCP callpowered_now_read → list_unpaid_invoices

  REST endpointGET https://cotlet.dev/api/v1/powered-now/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": "INV-3290",
        "customer": "Oakfield Lettings Ltd",
        "balance": "480.00",
        "days_overdue": 21
      }
    ]
  }

ToolWhat it doesAccess

• list_diary Appointments for a day or range, by team member. read

  Returns appointments with customer, site, team member, time and job.

  MCP callpowered_now_read → list_diary

  REST endpointGET https://cotlet.dev/api/v1/powered-now/diaries

  Parameters

  Parameters: list_diary

  Name	Type	Description
  date_from string required	string	ISO date.
  date_to string	string	ISO date. Default: date_from.
  who string	string	Team member.

  Example input

  {
    "date_from": "date from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "AP-7710",
        "customer": "Oakfield Lettings Ltd",
        "site": "22 Park Ave, Leeds",
        "who": "Craig",
        "start": "2026-11-10T08:30",
        "job": "Boiler service"
      }
    ]
  }

• book_appointment Books an appointment in the diary for you or a team member. writeasks first

  Creates the diary appointment at the site. Your settings decide whether the customer gets a confirmation. By default you confirm each call; you can switch that off for this tool.

  MCP callpowered_now_write → book_appointment

  REST endpointPOST https://cotlet.dev/api/v1/powered-now/customers/{customer_id}/appointments

  Parameters

  Parameters: book_appointment

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  start string required	string	ISO date and time.
  who string	string	Team member. Default: you.
  job string	string	What the visit is for.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "start": "start"
  }

  Example response

  {
    "appointment_id": "AP-7744",
    "customer": "Mr Dev Patel",
    "who": "Craig",
    "start": "2026-11-12T09:00",
    "job": "Consumer unit swap"
  }