xero-oauth-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| XERO_READONLY | No | When true, all write tools refuse. Default: unset | |
| XERO_CLIENT_ID | Yes | Xero app client ID (required) | |
| XERO_TOKEN_DIR | No | Where the token store lives. Default: ~/.xero-mcp-id | |
| XERO_DEFAULT_ORG | No | Default org when tool omits org (alias/tenantId/name). Defaults to first org. | |
| XERO_ORG_ALIASES | No | JSON map of friendly alias to tenantId, e.g. {"main":"<tenant-guid>"}. Default: {} | |
| XERO_CLIENT_SECRET | Yes | Xero app client secret (required) | |
| XERO_REDIRECT_PORT | No | Local callback port. Default: 49831 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_organisationsA | List the connected Xero organisations (orgs) and the default one. |
| list_accountsA | List the chart of accounts (codes, names, types, tax types) for an org — useful before creating invoices. |
| list_contactsB | List/search contacts in an org. |
| get_contactA | Get a single contact by its contactID. |
| create_contactC | [WRITE] Create a new contact. |
| update_contactA | [WRITE] Update an existing contact (only supplied fields change). |
| list_invoicesC | List/search invoices in an org. Filter by status, contact, invoice number, or a raw Xero filter. |
| get_invoiceA | Get a single invoice (with line items) by invoiceID or invoice number. |
| list_overdue_invoicesA | List overdue sales (ACCREC) invoices: AUTHORISED, past due date, with an outstanding balance. |
| list_recurring_invoicesC | List repeating (recurring) invoice templates in an org. |
| create_invoiceB | [WRITE] Create an invoice (sales ACCREC by default). Defaults to DRAFT status. |
| update_invoiceB | [WRITE] Update an invoice by invoiceID (e.g. change status, reference, due date, or line items). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Each tool targets a distinct resource and action (contact, invoice, accounts, etc.). Even specialized invoice tools like list_overdue_invoices and list_recurring_invoices have clear names that prevent ambiguity.
All tools follow a consistent verb_noun pattern (create_*, get_*, list_*, update_*), making it predictable and easy for an agent to infer purpose from the name.
With 12 tools covering core CRUD for contacts and invoices plus useful listing filters, the set is well-scoped for a Xero accounting API server—neither too sparse nor too overwhelming.
Covers the main workflows for contacts and invoices (create, read, update, list) with additional filters. Missing delete operations and account creation/update, but these are often handled externally or are less critical for basic usage.