Create client
Add a client with one contact, optionally with the currency to bill in.
MCP tool invoice_ninja_write → create_client
write
Creates a client with one contact and returns the client ID. The client record sets the currency, tax rules, language and payment terms for every invoice you create for it, so set the currency here if it differs from your company default. The Free plan allows up to 5 clients. create_client sends nothing to the client and runs without asking first; you can archive or delete the client in Invoice Ninja.
Parameters
| Name | Type | Description |
|---|---|---|
| company string | string | Company name, for accounts with several companies. Default: the company open when you signed in. |
| name string required | string | Client or company name. |
| contact_first_name string | string | First name of the contact. |
| contact_last_name string | string | Last name of the contact. |
| contact_email string | string | Email address that receives invoices and quotes. |
| currency string | string | Three-letter currency code, e.g. USD. Default: your company currency. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "invoice_ninja_write",
"arguments": {
"operation": "create_client",
"arguments": {
"name": "Jane Doe"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"client_id": "Zr41kPwe8c",
"name": "Kestrel Labs",
"contact": "Mia Ortega",
"email": "mia@kestrel.example",
"currency": "USD"
},
"isError": false
}