data
Xero MCP, CLI, and Lua Integration for AI Agents
Xero integration docs for AI agents: MCP gateway setup, Xero CLI commands, Lua API reference, credentials, and function schemas.Xero for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
xero.xero_create_invoice | Write write | 7 | Create a new invoice in Xero. Requires a contact_id and at least one line item with description and unit_amount. Returns the created invoice with its ID and number. |
xero.xero_get_contact | Read read | 1 | Retrieve a Xero contact by its ID. Returns the contact's ID, name, email, phone, addresses, and status. |
xero.xero_get_current_user | Read read | 0 | Retrieve the currently authenticated Xero user. Returns the user's ID, name, and email. Useful for identifying which Xero organisation or token is in use. |
xero.xero_get_invoice | Read read | 1 | Retrieve a Xero invoice by its ID. Returns the full invoice including line items, contact details, and totals. |
xero.xero_list_accounts | Read read | 2 | List Xero chart of accounts. Returns account codes, names, types, tax types, and statuses. |
xero.xero_list_contacts | Read read | 4 | List Xero contacts with pagination. Returns contact IDs, names, emails, and types. Use page for pagination (1-indexed). |
xero.xero_list_invoices | Read read | 5 | List Xero invoices with pagination and filtering. Returns invoice IDs, numbers, amounts, status, and dates. Use page and pageSize for pagination. |