List contacts
list_contactsList or search customers and suppliers by free-text query across name, email, phone, tax number, and address, or apply structured filters to narrow results.
Instructions
List or search contacts (customers and suppliers). Supply query for free-text search across name, email, phone, customer id, tax number and address, or filter for structured narrowing.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. | |
| query | No | Free-text search term. | |
| filter | No | Comma-separated `key:value` filter. Keys: created_after, updated_after, first_name, last_name, contact_type (all|company|private_individual), delivery_method (all|email|post|manual|peppol|simplerinvoicing), trusted_type (all|trusted|not_trusted), estimate_workflow_id, invoice_workflow_id. A filter replaces Moneybird's defaults entirely. | |
| per_page | No | Records per page (max 100, Moneybird defaults to 50). | |
| include_archived | No | ||
| administration_id | No | Administration to act on. Defaults to the administration this server was configured with; call list_administrations to discover the available ids. |