Xero Accounting Skill

Interact with Xero accounting software via CLI. Manage invoices, contacts, payments, bank transactions, and more. All commands output JSON for easy parsing.

Script Directory

Agent: Determine this SKILL.md file's directory as SKILL_DIR, then run commands with:

CODEBLOCK0

Setup

1. Get Xero Credentials

Users need a Xero Developer account with API credentials:

1. 1. Go to developer.xero.com/app/manage
2. Create a Web App
3. Set redirect URI: INLINECODE1
4. Copy the Client ID and Client Secret

Note: If you see a scopes configuration page, add: openid, offline_access, accounting.contacts, accounting.settings, accounting.invoices, accounting.payments, accounting.banktransactions, accounting.attachments. If no scopes page is shown, that's fine - scopes are requested during OAuth.

Agent note: If credentials are missing, ask the user for their Client ID and Secret.

2. Configure OpenClaw

Add credentials to openclaw.json:

CODEBLOCK1

3. Authenticate

CODEBLOCK2

This opens a browser for OAuth. Once complete, verify with:

CODEBLOCK3

Quick Reference

Command prefix: INLINECODE11

Authentication

Command	Description
INLINECODE12	Start OAuth flow (opens browser)
INLINECODE13

Check authentication status | | auth logout | Clear stored credentials |

Organizations

Command	Description
INLINECODE15	List connected Xero organizations
INLINECODE16

Switch active organization |

Invoices

Command	Description
INLINECODE17	List all invoices
INLINECODE18

Filter by status | | invoices list --contact <id> | Filter by contact | | invoices get <id> | Get invoice details | | invoices create --contact <id> --items '<json>' | Create invoice | | invoices update <id> --status AUTHORISED | Update status |

Statuses: DRAFT, AUTHORISED, PAID, INLINECODE26

Types: ACCREC (sales), ACCPAY (bills)

Contacts

Command	Description
INLINECODE29	List all contacts
INLINECODE30

Search by name | | contacts list --customers | Only customers | | contacts list --suppliers | Only suppliers | | contacts get <id> | Get contact details | | contacts create --name "X" --email "Y" | Create contact |

Accounts

Command	Description
INLINECODE35	List all accounts
INLINECODE36

Filter by type | | accounts list --class EXPENSE | Filter by class | | accounts get <id> | Get account details |

Types: BANK, REVENUE, EXPENSE, FIXED, CURRENT, LIABILITY, EQUITY, etc.

Classes: ASSET, EQUITY, EXPENSE, LIABILITY, INLINECODE50

Bank Transactions

Command	Description
INLINECODE51	List all transactions
INLINECODE52

Filter by type | | banktransactions get <id> | Get details | | banktransactions create ... | Create transaction | | banktransactions attach <id> <file> | Attach file |

Types: SPEND, RECEIVE, RECEIVE-OVERPAYMENT, INLINECODE59

Payments

Command	Description
INLINECODE60	List all payments
INLINECODE61

Filter by invoice | | payments get <id> | Get payment details | | payments create ... | Create payment | | payments delete <id> | Void payment |

Allocations

Command	Description
INLINECODE65	List overpayments
INLINECODE66

List prepayments | | allocations list-creditnotes | List credit notes | | allocations overpayment -o <id> -i <inv> -a <amt> | Apply overpayment | | allocations prepayment -p <id> -i <inv> -a <amt> | Apply prepayment | | allocations creditnote -c <id> -i <inv> -a <amt> | Apply credit note |

Examples

Create an Invoice

CODEBLOCK4

Record a Payment

CODEBLOCK5

Create a Contact

CODEBLOCK6

Record Bank Transaction with Receipt

CODEBLOCK7

Error Handling

Errors return JSON:

CODEBLOCK8

Common errors:

Error	Solution
Not authenticated	Run INLINECODE71
Token expired

Run auth login again |
| No organization selected | Run tenants list then tenants select <id> |

Security Notes

Token Storage: OAuth tokens are saved to data/tokens.json in the working directory. This file contains sensitive access/refresh tokens - treat it as you would other credentials.

Environment Variables: The skill reads XERO_CLIENT_ID and XERO_CLIENT_SECRET from environment (set via OpenClaw config). Optional: XERO_REDIRECT_URI (default: http://localhost:5001/callback) and XERO_SCOPES.

Source Code: All skill code is bundled in the scripts/ directory for inspection. Review before granting access to production Xero organizations.