Creates a DRAFT invoice only. This tool does not finalize or send invoices or collect payment. Requires a client name and line items (or totalAmount shorthand)…
Use with an AI agent
Export this page as Markdown or bundle it with a task for your agent.
Try a task
Preview the prompt that will be copied
Access
- Effect: Creates data
- Required scope:
write(themcpscope also grants it)
Example request
The JSON-RPC message an MCP client sends to call this tool. Your client builds it for you; this is for reference and debugging in a tool such as MCP Inspector.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "create_invoice",
"arguments": {}
}
}Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.
Description
Creates a DRAFT invoice only. This tool does not finalize or send invoices or collect payment. Requires a client name and line items (or totalAmount shorthand). If accountId is omitted, it uses Main Checking or the only accessible account when unambiguous; otherwise it asks which account. Dates default when omitted; currency defaults to the account's currency. When line items are omitted and totalAmount is provided, it creates one Services line item; invoice totals are calculated from line items. clientName and the amount are NEVER invented — if they are missing this tool returns guidance asking you to clarify with the user.Input parameters
| Name | Type | Required | Description |
|---|---|---|---|
accountId | string | No | |
clientName | string | No | |
contactDetails | string | No | |
currency | string | No | |
deliveryMethod | string | No | |
description | string | No | |
dueDate | string | No | |
issuedAtDate | string | No | |
items | array | No | |
reminderFrequency | string | No | |
totalAmount | number | No |
Full input schema (JSON Schema)
{
"additionalProperties": false,
"properties": {
"accountId": {
"type": "string"
},
"clientName": {
"type": "string"
},
"contactDetails": {
"type": "string"
},
"currency": {
"type": "string"
},
"deliveryMethod": {
"type": "string"
},
"description": {
"type": "string"
},
"dueDate": {
"type": "string"
},
"issuedAtDate": {
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"description": {
"type": "string"
},
"discount": {
"type": "number"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"quantity": {
"type": "integer"
},
"taxRate": {
"type": "number"
},
"unitPrice": {
"type": "number"
}
},
"required": [
"id",
"name",
"description",
"unitPrice",
"currency",
"quantity",
"taxRate",
"discount"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"reminderFrequency": {
"type": "string"
},
"totalAmount": {
"type": "number"
}
},
"type": "object"
}