# create\_invoice

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)…

Last updated October 1, 2026

## Access

*   Effect: **Creates data**
*   Required scope: `write` (the `mcp` scope 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.

```json
{
  "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)

```json
{
  "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"
}
```

Source: https://financesavi.com/developers/mcp/tools/create_invoice
