create_party
Create a customer, vendor, or employee in GnuCash accounting, returning the assigned ID for later transactions. Each call adds a fresh party without checking for duplicates.
Instructions
Create a customer, vendor, or employee.
Additive: each call creates a fresh party — names are NOT checked for duplicates, so list_parties first when unsure. Returns the assigned ID (e.g., "000001"), the handle every later call wants. ID counters are PER TYPE: customer 000001 and vendor 000001 are different parties, which is why party_type is required everywhere.
Args: party_type: "customer" (pays you), "vendor" (you pay), or "employee" (expense-voucher workflows). name: Party name (e.g., "Acme Corp", "Jane Smith"). currency: ISO currency code (e.g., "USD", "EUR"). Defaults to book's default currency. notes: Optional notes (max 4096 characters). Employees have no notes field — rejected, not ignored. address: Optional address with keys: name, addr1, addr2, addr3, addr4, phone, fax, email. Each sub-field capped at 1024 characters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| notes | No | Optional notes. Capped at 4096 characters at the MCP boundary; oversize input rejects with a clear error. | |
| address | No | ||
| currency | No | ||
| party_type | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |