List invoices
Invoices with number, customer, status, dates and total, newest first.
MCP tool sevdesk_read → list_invoices
read
Lists invoices newest first, with the customer, status, invoice date, due date and gross total. Status draft, open, due, paid or cancelled matches the tabs of the Rechnungen overview; due is the Fällig tab and cancelled the Storno tab. Filter by customer, invoice number or date range. Pages hold up to 100 invoices; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | draft, open, due, paid or cancelled. Default: all. |
| contact_id string | string | Only invoices of this customer, from list_contacts. |
| invoice_number string | string | Exact invoice number, e.g. RE-1031. |
| from_date date | date | Only invoices dated on or after this date. |
| to_date date | date | Only invoices dated on or before this date. |
| limit integer | integer | 1 to 100. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "sevdesk_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"invoice_id": "41872618",
"invoice_number": "RE-1031",
"contact": {
"contact_id": "3084102",
"name": "Brandt GmbH"
},
"status": "due",
"invoice_date": "2026-09-14",
"due_date": "2026-09-28",
"total_gross": 226.1,
"currency": "EUR"
}
],
"next_cursor": null
},
"isError": false
}