Minuba API and MCP server Let your AI agent run your Minuba orders.

ToolWhat it doesAccess

• list_orders Orders and quotes with number, client, state and the date it is pending until. read

  Lists orders and quotes. Filter by state, order number or last change. Returns the number, name, client, state, assigned employees and the pending date and note when one is set. Nothing is changed.

  MCP callminuba_read → list_orders

  REST endpointGET https://cotlet.dev/api/v1/minuba/orders

  Parameters

  Parameters: list_orders

  Name	Type	Description
  state string	string	One of proposal_draft, proposal, order_draft, new, started, delayed, completed, closed, rejected.
  order_number integer	integer	Exact order number.
  updated_after date	date	Only orders changed on or after this date.
  all_employees boolean	boolean	Include orders assigned to other employees. Needs a role that can see them.
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "orders": [
      {
        "order_id": "ord_20418",
        "order_number": 20418,
        "name": "Badeværelse hos Hansen",
        "client": "Familien Hansen",
        "state": "started",
        "pending_date": null
      },
      {
        "order_id": "ord_20411",
        "order_number": 20411,
        "name": "Varmepumpe, Skovvej 12",
        "client": "Skovvej Boligforening",
        "state": "delayed",
        "pending_date": "2026-10-28",
        "pending_note": "Waiting for supplier"
      }
    ],
    "next_cursor": null
  }

• get_order One order with client, address, state, employees, pending note and totals. read

  Returns one order as its work slip shows it: client and address, state, assigned employees, the pending date and note, and the hours and material lines registered so far. Prices are left out for a user without price access. Nothing is changed.

  MCP callminuba_read → get_order

  REST endpointGET https://cotlet.dev/api/v1/minuba/orders/{order_id}

  Parameters

  Parameters: get_order

  Name	Type	Description
  order_id string required	string	Order ID from list_orders.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_id": "ord_20418",
    "order_number": 20418,
    "name": "Badeværelse hos Hansen",
    "client": "Familien Hansen",
    "address": "Egevej 7, 2800 Kongens Lyngby",
    "state": "started",
    "employees": [
      "Jens Madsen",
      "Ali Yilmaz"
    ],
    "hours_registered": 31.5,
    "material_lines": 9
  }

• list_clients Clients from the customer register with number, CVR and contact details. read

  Searches the customer register by client number or CVR (org number) and returns name, address, email and phone. Use it before create_client to avoid a duplicate. Nothing is changed.

  MCP callminuba_read → list_clients

  REST endpointGET https://cotlet.dev/api/v1/minuba/clients

  Parameters

  Parameters: list_clients

  Name	Type	Description
  client_number integer	integer	Exact client number.
  org_number string	string	CVR number.
  updated_after date	date	Only clients changed on or after this date.

  Example response

  {
    "clients": [
      {
        "client_id": "cli_3302",
        "client_number": 3302,
        "name": "Skovvej Boligforening",
        "org_number": "29384756",
        "email": "bestyrelse@skovvej.example",
        "phone": "+45 31 00 00 01"
      }
    ]
  }

• list_users Employees with their user type, for time checks and assigning work. read

  Lists the users of the company with name and user type (administrative, limited or resource). Use the IDs with list_timesheet_entries. Nothing is changed.

  MCP callminuba_read → list_users

  REST endpointGET https://cotlet.dev/api/v1/minuba/users

  Parameters

  No parameters.

  Example response

  {
    "users": [
      {
        "user_id": "usr_11",
        "name": "Jens Madsen",
        "user_type": "resource"
      },
      {
        "user_id": "usr_12",
        "name": "Ali Yilmaz",
        "user_type": "limited"
      },
      {
        "user_id": "usr_01",
        "name": "Mette Holm",
        "user_type": "administrative"
      }
    ]
  }

• create_client Add a client to the customer register. write

  Adds one client and returns its client_id and number. Check list_clients first so you do not create a duplicate. The client is told nothing. It reaches no one and is undone by deleting the client in Minuba, so it runs without asking.

  MCP callminuba_write → create_client

  REST endpointPOST https://cotlet.dev/api/v1/minuba/clients

  Parameters

  Parameters: create_client

  Name	Type	Description
  name string required	string	Client name.
  org_number string	string	CVR number for a company.
  email string	string	Contact email.
  phone string	string	Phone number.
  address string	string	Street, postcode and city.

  Example input

  {
    "name": "Jane Doe"
  }

  Example response

  {
    "client_id": "cli_3318",
    "client_number": 3318,
    "name": "Nordlys Tømrer ApS",
    "org_number": "12345678"
  }

• create_order Open an order or quote draft for a client. Nothing is sent to the client. write

  Creates a draft for one client and returns the order_id and number. Choose a quote draft or an order draft. The draft stays in Minuba until someone approves it there. It reaches no one and is undone by deleting the draft, so it runs without asking.

  MCP callminuba_write → create_order

  REST endpointPOST https://cotlet.dev/api/v1/minuba/clients/{client_id}/orders

  Parameters

  Parameters: create_order

  Name	Type	Description
  client_id string required	string	Client ID from list_clients or create_client.
  name string required	string	Order name.
  kind string	string	proposal_draft or order_draft. Default: order_draft.
  description string	string	What the job is.

  Example input

  {
    "client_id": "client_8c41d2",
    "name": "Jane Doe"
  }

  Example response

  {
    "order_id": "ord_20431",
    "order_number": 20431,
    "name": "Tagreparation",
    "client": "Nordlys Tømrer ApS",
    "state": "proposal_draft"
  }

ToolWhat it doesAccess

• list_timesheet_entries Registered time per employee and day, with order, work type and note. read

  Returns time entries of one employee or of everyone for a date range. Each entry shows whether it is order-related, not order-related or absence, the order it sits on, the work type and the note. Nothing is changed.

  MCP callminuba_read → list_timesheet_entries

  REST endpointGET https://cotlet.dev/api/v1/minuba/timesheet-entries

  Parameters

  Parameters: list_timesheet_entries

  Name	Type	Description
  user_id string	string	Employee ID from list_users. Leave out for all employees you may see.
  date_from date	date	First day.
  date_to date	date	Last day.

  Example response

  {
    "entries": [
      {
        "entry_id": "te_90311",
        "user": "Jens Madsen",
        "date": "2026-10-26",
        "hours": 7.5,
        "kind": "order",
        "order_number": 20418,
        "work_type": "Montering",
        "note": "Fliser i bad"
      },
      {
        "entry_id": "te_90312",
        "user": "Ali Yilmaz",
        "date": "2026-10-26",
        "hours": 8,
        "kind": "order",
        "order_number": 20418,
        "work_type": "Montering",
        "note": ""
      }
    ]
  }

• register_time Log hours on an order, or as non-order time, for an employee. write

  Adds a time entry for the signed-in employee, or for another one if your role allows it. Give an order to make it order-related; leave the order out for non-order time. Times follow the 15 or 30 minute interval set in the company settings. The hours land on the work slip and in the invoice basis. It reaches no one and is undone by deleting the entry, so it runs without asking.

  MCP callminuba_write → register_time

  REST endpointPOST https://cotlet.dev/api/v1/minuba/times

  Parameters

  Parameters: register_time

  Name	Type	Description
  order_id string	string	Order ID from list_orders. Leave out for time not related to an order.
  date date required	date	Day of the work.
  start_time string required	string	Start, HH:MM.
  end_time string required	string	End, HH:MM.
  work_type string	string	Work type as your company set it up, for example Montering.
  note string	string	What was done. It can appear on the customer invoice, depending on your settings.
  user_id string	string	Employee ID from list_users. Default: the signed-in user.

  Example input

  {
    "order_id": "ord_20418",
    "date": "2026-10-31",
    "start_time": "08:00",
    "end_time": "14:00",
    "work_type": "Montering",
    "note": "Fuger og silikone"
  }

  Example response

  {
    "entry_id": "te_90340",
    "order_number": 20418,
    "date": "2026-10-31",
    "hours": 6,
    "work_type": "Montering",
    "note": "Fuger og silikone"
  }

• list_order_materials Material lines registered on an order, with quantity and whether they are left off the invoice. read

  Returns the material registrations on one order: material number, description, quantity, who registered it and when, and whether the line is excluded from invoicing. Nothing is changed.

  MCP callminuba_read → list_order_materials

  REST endpointGET https://cotlet.dev/api/v1/minuba/order-materials

  Parameters

  Parameters: list_order_materials

  Name	Type	Description
  order_id string required	string	Order ID from list_orders.
  registered_after date	date	Only lines registered on or after this date.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_number": 20418,
    "lines": [
      {
        "material_no": "4410",
        "description": "Fugemasse, 310 ml",
        "quantity": 3,
        "registered_by": "Jens Madsen",
        "date": "2026-10-26",
        "excluded_from_invoice": false
      },
      {
        "material_no": "0001",
        "description": "Parkering",
        "quantity": 1,
        "registered_by": "Ali Yilmaz",
        "date": "2026-10-26",
        "excluded_from_invoice": true
      }
    ]
  }

• register_material Add a material line to an order from your material list. write

  Adds a quantity of one material from your material list to the order. The line appears on the work slip and flows into the invoice draft unless the material is marked to stay off invoices. It reaches no one and is undone by deleting the line, so it runs without asking.

  MCP callminuba_write → register_material

  REST endpointPOST https://cotlet.dev/api/v1/minuba/orders/{order_id}/materials

  Parameters

  Parameters: register_material

  Name	Type	Description
  order_id string required	string	Order ID from list_orders.
  material_no string required	string	Material number from your material list.
  quantity number required	number	Amount used.

  Example input

  {
    "order_id": "order_8c41d2",
    "material_no": "material no",
    "quantity": 1
  }

  Example response

  {
    "order_number": 20418,
    "material_no": "4410",
    "description": "Fugemasse, 310 ml",
    "quantity": 3,
    "excluded_from_invoice": false
  }

• list_order_documents Photos and files on an order with folder, uploader and who can see them. read

  Lists the files in the Documentation section of an order: file name, folder, uploader, upload date and who the file is visible to. It returns names and metadata, not the file content. Nothing is changed.

  MCP callminuba_read → list_order_documents

  REST endpointGET https://cotlet.dev/api/v1/minuba/order-documents

  Parameters

  Parameters: list_order_documents

  Name	Type	Description
  order_id string required	string	Order ID from list_orders.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_number": 20418,
    "files": [
      {
        "name": "vandskade-foer.jpg",
        "folder": "Før",
        "uploaded_by": "Jens Madsen",
        "date": "2026-10-24",
        "visible_to": "everyone"
      },
      {
        "name": "tegning-bad.pdf",
        "folder": "Tegninger",
        "uploaded_by": "Mette Holm",
        "date": "2026-10-22",
        "visible_to": "administrators and billing"
      }
    ]
  }

ToolWhat it doesAccess

• list_invoices Invoices with order, state, total and whether they went to the accounting system. read

  Lists invoices as Minuba shows them: drafts, invoiced and credited. Returns the invoice number, order, client, total and the export status. Set not_exported to see only invoices not yet sent to the accounting system. Nothing is changed.

  MCP callminuba_read → list_invoices

  REST endpointGET https://cotlet.dev/api/v1/minuba/invoices

  Parameters

  Parameters: list_invoices

  Name	Type	Description
  state string	string	One of draft, invoiced, credited.
  order_id string	string	Only invoices of this order.
  not_exported boolean	boolean	Only invoices not yet exported to the accounting system.
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "invoices": [
      {
        "invoice_id": "inv_7710",
        "invoice_number": 5521,
        "order_number": 20405,
        "client": "Skovvej Boligforening",
        "state": "draft",
        "net": 12000,
        "vat": 3000,
        "total": 15000,
        "currency": "DKK",
        "exported": false
      }
    ],
    "next_cursor": null
  }

• send_invoice Send an invoice to the client by email or EAN. writeasks first

  Sends one invoice to the client by email or EAN, as the send action in Minuba does. The client receives it and is asked to pay. An approved invoice is locked in Minuba, so a mistake needs a credit note. By default you confirm each call; you can switch that off for this tool.

  MCP callminuba_write → send_invoice

  REST endpointPOST https://cotlet.dev/api/v1/minuba/invoices/{invoice_id}

  Parameters

  Parameters: send_invoice

  Name	Type	Description
  invoice_id string required	string	Invoice ID from list_invoices.
  channel string required	string	email or ean.
  message string	string	Note in the email.

  Example input

  {
    "invoice_id": "invoice_8c41d2",
    "channel": "channel"
  }

  Example response

  {
    "invoice_id": "inv_7710",
    "invoice_number": 5521,
    "status": "sent",
    "channel": "email",
    "sent_to": "bestyrelse@skovvej.example",
    "total": 15000,
    "currency": "DKK"
  }

• list_service_agreements Recurring service agreements with client, interval and next visit. read

  Lists the service agreements, which act as templates for orders at fixed intervals. Returns the client, the interval, the responsible employee and the date of the next visit. Needs the service agreement module on your account. Nothing is changed.

  MCP callminuba_read → list_service_agreements

  REST endpointGET https://cotlet.dev/api/v1/minuba/service-agreements

  Parameters

  Parameters: list_service_agreements

  Name	Type	Description
  client_id string	string	Client ID from list_clients.
  due_before date	date	Only agreements with a next visit before this date.

  Example response

  {
    "agreements": [
      {
        "agreement_id": "sa_204",
        "client": "Skovvej Boligforening",
        "name": "Årligt serviceeftersyn varmepumpe",
        "interval": "yearly",
        "responsible": "Jens Madsen",
        "next_visit": "2026-11-18"
      }
    ]
  }