xero-automation
π―SkillInstallation
npx skills add composiohq/awesome-claude-skills --skill xero-automationRun it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).
Uses skills.sh Β· Node.js 22.20+
After installing
Ask for related work and the agent uses it on its own, or call it yourself.
/Xero AutomationInstall by hand
Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.
Open the skill folder β- This project
.claude/skills/xero-automation/ - All projects
~/.claude/skills/xero-automation/
These paths are for Claude Code. For other tools, the command above puts it in the right place.
SKILL.md
View on GitHub βXero Automation: manage invoices, contacts, payments, bank transactions, and accounts in Xero for cloud-based bookkeeping
Xero Automation
Automate Xero accounting operations including managing invoices, contacts, payments, bank transactions, and chart of accounts for small business bookkeeping.
Toolkit docs: composio.dev/toolkits/xero
Setup
This skill requires the Rube MCP server connected at https://rube.app/mcp.
Before executing any tools, ensure an active connection exists for the xero toolkit. If no connection is active, initiate one via RUBE_MANAGE_CONNECTIONS.
Multi-tenant: If you manage multiple Xero organizations, first call XERO_GET_CONNECTIONS to list active tenants and obtain the correct tenant_id for subsequent calls.
Core Workflows
1. List and Filter Invoices
Retrieve invoices with filtering by status, contact, date range, and pagination.
Tool: XERO_LIST_INVOICES
Key Parameters:
Statuses-- Comma-separated status filter:"DRAFT","SUBMITTED","AUTHORISED","PAID"ContactIDs-- Comma-separated Contact IDs to filter byInvoiceIDs-- Comma-separated Invoice IDs to filter bywhere-- OData-style filter, e.g.,"Status==\"AUTHORISED\" AND Total>100"order-- Sort expression, e.g.,"Date DESC","InvoiceNumber ASC"page-- Page number for paginationIf-Modified-Since-- UTC timestamp; returns only invoices modified since this datetenant_id-- Xero organization ID (uses first tenant if omitted)
Example:
Tool: XERO_LIST_INVOICES
Arguments:
Statuses: "AUTHORISED,PAID"
order: "Date DESC"
page: 1
2. Manage Contacts
Retrieve and search contacts for use in invoices and transactions.
Tool: XERO_GET_CONTACTS
Key Parameters:
searchTerm-- Case-insensitive search across Name, FirstName, LastName, Email, ContactNumberContactID-- Fetch a single contact by IDwhere-- OData filter, e.g.,"ContactStatus==\"ACTIVE\""page,pageSize-- Pagination controlsorder-- Sort, e.g.,"UpdatedDateUTC DESC"includeArchived-- Include archived contacts whentruesummaryOnly-- Lightweight response whentrue
Example:
Tool: XERO_GET_CONTACTS
Arguments:
searchTerm: "acme"
page: 1
pageSize: 25
Note: On high-volume accounts, some
wherefilters (e.g.,IsCustomer,IsSupplier) may be rejected by Xero. Fall back tosearchTermor pagination.
3. Create Payments
Link an invoice to a bank account by creating a payment record.
Tool: XERO_CREATE_PAYMENT
Key Parameters:
InvoiceID(required) -- Xero Invoice ID the payment applies toAccountID(required) -- Bank account ID for the paymentAmount(required) -- Payment amount (number)Date-- Payment date inYYYY-MM-DDformatReference-- Payment reference or descriptionCurrencyRate-- Exchange rate for foreign currency payments
Example:
Tool: XERO_CREATE_PAYMENT
Arguments:
InvoiceID: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
AccountID: "b2c3d4e5-f6a7-8901-bcde-f12345678901"
Amount: 1500.00
Date: "2026-02-11"
Reference: "Payment for INV-0042"
4. Create Bank Transactions
Record spend (payments out) or receive (money in) bank transactions.
Tool: XERO_CREATE_BANK_TRANSACTION
Key Parameters:
Type(required) --"SPEND"(payment out) or"RECEIVE"(money in)ContactID(required) -- Xero Contact IDBankAccountCode(required) -- Bank account code from chart of accountsLineItems(required) -- Array of line items, each with:Description(required) -- Line item descriptionUnitAmount(required) -- Unit priceAccountCode(required) -- Account code for categorizationQuantity-- Quantity (default 1)TaxType-- Tax type:"OUTPUT","INPUT","NONE"
Date-- Transaction date inYYYY-MM-DDformatReference-- Transaction referenceStatus--"AUTHORISED"or"DELETED"CurrencyCode-- e.g.,"USD","EUR"
Example:
Tool: XERO_CREATE_BANK_TRANSACTION
Arguments:
Type: "SPEND"
ContactID: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
BankAccountCode: "090"
LineItems: [
{
"Description": "Office supplies",
"UnitAmount": 75.00,
"AccountCode": "429",
"Quantity": 1,
"TaxType": "INPUT"
}
]
Date: "2026-02-11"
Reference: "Feb office supplies"
5. List Payments and Bank Transactions
Review existing payments and bank transaction history.
Tools:
XERO_LIST_PAYMENTS-- List payments linking invoices to bank transactionsXERO_LIST_BANK_TRANSACTIONS-- List spend/receive bank transactions
Common Parameters:
where-- OData filter, e.g.,"Status==\"AUTHORISED\""order-- Sort expression, e.g.,"Date DESC"page-- Page number for paginationIf-Modified-Since-- Incremental updates since timestamptenant_id-- Organization ID
6. View Chart of Accounts and Connections
Tools:
XERO_LIST_ACCOUNTS-- Retrieve all account codes for categorizing transactionsXERO_GET_CONNECTIONS-- List active Xero tenant connectionsXERO_LIST_ATTACHMENTS-- List attachments on an entity (invoice, contact, etc.)
Known Pitfalls
| Pitfall | Detail |
|---|---|
| Multi-tenant routing | If tenant_id is omitted, the first connected tenant is used. Always verify the correct tenant with XERO_GET_CONNECTIONS when managing multiple organizations. |
| High-volume filter rejection | On large accounts, some where filters like IsCustomer/IsSupplier may be rejected. Fall back to searchTerm with pagination. |
| OData filter syntax | Use double-equals (==) in OData filters, e.g., Status==\"AUTHORISED\". Single = causes errors. |
| Pagination required | Most list endpoints paginate results. Always check for additional pages and continue fetching until complete. |
| Date format | All dates must be in YYYY-MM-DD format. Timestamps for If-Modified-Since must be full ISO 8601 UTC datetime. |
| Bank account codes | BankAccountCode in bank transactions must match a valid code from the chart of accounts. Use XERO_LIST_ACCOUNTS to discover valid codes. |
Quick Reference
| Tool Slug | Description |
|---|---|
XERO_LIST_INVOICES | List invoices with filtering and pagination |
XERO_GET_CONTACTS | Retrieve and search contacts |
XERO_CREATE_PAYMENT | Create a payment linking invoice to bank account |
XERO_CREATE_BANK_TRANSACTION | Record a spend or receive bank transaction |
XERO_LIST_PAYMENTS | List payment records |
XERO_LIST_BANK_TRANSACTIONS | List bank transactions |
XERO_LIST_ACCOUNTS | Retrieve chart of accounts |
XERO_GET_CONNECTIONS | List active Xero tenant connections |
XERO_LIST_ATTACHMENTS | List attachments on an entity |
Powered by Composio
More from this repository10
A Claude Code plugin that analyzes meeting notes and transcripts to extract key insights, action items, and decisions using Composio app integrations.
A Claude Code plugin from the Awesome Claude Skills collection that downloads videos from YouTube and other platforms for offline viewing, editing, or archival, with support for various formats and quality options.
A Claude Code plugin that automatically organizes and categorizes files in your workspace using Composio integrations, helping maintain a clean project structure.
A Claude Code plugin that assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback.
A Claude Code plugin providing tools for creating elaborate, multi-component HTML artifacts using React, Tailwind CSS, and shadcn/ui in claude.ai.
A Claude Code skill that randomly selects winners from participant lists, spreadsheets, or Google Sheets for giveaways and contests using cryptographically secure randomness.
A Claude Code plugin that automates Zoho CRM workflows including lead management, contact updates, deal tracking, account operations, and custom module interactions through Composio integration.
A Claude Code plugin that enforces brand consistency by checking code and content against your brand guidelines using Composio integrations.
A pre-built workflow skill for automating Help Scout via Composio, enabling Claude to manage conversations, customers, mailboxes, and tags through structured tool sequences and parameter guidance.
A Claude Code plugin that automatically creates user-facing changelogs from git commits by analyzing commit history and transforming technical commits into customer-friendly release notes.