Skip to main content
Glama
Xero MCP Server

Xero MCP Server

Xero MCP Server

This MCP server allows Clients to interact with Xero Accounting Software.

Get Started

  1. Make sure node is installed.

  2. Create an OAuth 2.0 app in Xero to get a CLIENT_ID and CLIENT_SECRET.

    • Create a free Xero user account (if you don't have one)

    • Login to Xero Developer center https://developer.xero.com/app/manage/

    • Click New app

    • Enter a name for your app

    • Select Web app

    • Provide a valid URL (can be anything valid eg. https://www.myapp.com)

    • Enter redirect URI: http://localhost:5000/callback

      Note: The redirect URI can be customized, but it must use localhost and include both an explicit port and a path (e.g. http://localhost:5050/my-path). Set the same value as XERO_REDIRECT_URI in your MCP client config below.

    • Tick to Accept the Terms & Conditions and click Create app

    • On the left-hand side of the screen select Configuration

    • Click Generate a secret

  3. Configure your MCP client:

    Claude Desktop

    Go to Settings -> Developers -> Local MCP Servers -> Edit Config and add the following to claude_desktop_config.json:

    {
      "mcpServers": {
        "xero-mcp": {
          "command": "npx",
          "args": ["-y", "xero-mcp@latest"],
          "env": {
            "XERO_CLIENT_ID": "YOUR_CLIENT_ID",
            "XERO_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
            "XERO_REDIRECT_URI": "http://localhost:5000/callback"
          }
        }
      }
    }

    Restart Claude Desktop, or reload via Developer -> Reload MCP Configuration.

    Claude Code

    Run the following command to add the MCP server:

    claude mcp add xero-mcp \
      -e XERO_CLIENT_ID=YOUR_CLIENT_ID \
      -e XERO_CLIENT_SECRET=YOUR_CLIENT_SECRET \
      -e XERO_REDIRECT_URI=http://localhost:5000/callback \
      -- npx -y xero-mcp@latest

    The server will be available in your next Claude Code session. To make it available across all projects, add --scope user to the command above.

  4. When accessing a Xero tool for the first time, a Xero login page will pop up to ask your consent. Complete the auth flow and manually close the web page (as the Xero page will not auto close in this version)

    Privacy alert: after completing the Xero OAuth2 flow, your Xero data may go through the LLM that you use. If you are doing testing you should authorize to your Xero Demo Company.

Related MCP server: xero-mcp-enhanced

Tools

  • authenticate

    Authenticate with Xero using OAuth2

  • create_bank_transactions

    Creates one or more spent or received money transaction

  • create_contacts

    Creates one or multiple contacts in a Xero organisation

  • get_balance_sheet

    Retrieves report for balancesheet

  • get_bank_transaction

    Retrieves a single spent or received money transaction by its Xero bank transaction ID

  • get_invoice

    Retrieves a single sales invoice or purchase bill by its Xero invoice ID

  • list_accounts

    Retrieves the full chart of accounts

  • list_bank_transactions

    Retrieves any spent or received money transactions

  • list_contacts

    Retrieves all contacts in a Xero organisation

  • list_invoices

    Retrieves sales invoices or purchase bills

  • list_organisations

    Retrieves Xero organisation details

  • list_payments

    Retrieves payments for invoices and credit notes

  • list_quotes

    Retrieves sales quotes

  • update_bank_transaction

    Updates an existing spent or received money transaction (e.g. line items, contact, bank account) by bank transaction ID

  • update_invoice

    Updates an existing sales invoice or purchase bill (typically a draft), including line items and account codes

Examples

  • "Visualize my financial position over the last month"

  • "Track my spendings over last week"

  • "Add all transactions from the monthly statement into my revenue account (account code 201) as receive money"

License

MIT

Available Tools

15 tools
authenticateC

Authenticate with Xero using OAuth2

Inputs: no named parameters.

create_bank_transactionsB

Creates one or more spent or received money transaction. Only use this tool when user has directly and explicitly ask you to create transactions.

Inputs: Warnings, pagination, BankTransactions.

create_contactsA

Creates one or multiple contacts in a Xero organisation. Only use this tool when user has directly and explicitly ask you to create contact.

Inputs: Contacts, Warnings, pagination.

get_balance_sheetC

Returns a balance sheet for the end of the month of the specified date. It also returns the value at the end of the same month for the previous year.

Inputs: no named parameters.

get_bank_transactionA

Retrieves a single spent or received money transaction by its Xero bank transaction ID

Inputs: bankTransactionID (required), unitdp.

get_invoiceA

Retrieves a single sales invoice or purchase bill by its Xero invoice ID

Inputs: invoiceID (required), unitdp.

list_accountsB

Retrieves the full chart of accounts

Inputs: order, where.

list_bank_transactionsB

Retrieves any spent or received money transactions

Inputs: page, order, where.

list_contactsC

Retrieves all contacts in a Xero organisation

Inputs: page, order, where, searchTerm, +1 more.

list_invoicesC

Retrieves sales invoices or purchase bills

Inputs: page, order, where, statuses, +3 more.

list_organisationsB

Retrieves Xero organisation details

Inputs: no named parameters.

list_paymentsB

Retrieves payments for invoices and credit notes

Inputs: page, order, where.

list_quotesB

Retrieves sales quotes

Inputs: page, order, dateTo, status, +5 more.

update_bank_transactionC

Updates an existing spent or received money transaction by its Xero bank transaction ID

Inputs: bankTransactions (required), bankTransactionID (required), unitdp, idempotencyKey.

update_invoiceA

Updates an existing sales invoice or purchase bill (typically a draft) to change fields like line items and account codes

Inputs: invoices (required), invoiceID (required), unitdp, idempotencyKey.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool has a distinct purpose: authentication, CRUD for specific entities (bank transactions, contacts, invoices), and read-only lists for accounts, organisations, payments, quotes. No functional overlap, and descriptions clearly differentiate between list/get and create/update operations.

    Naming Consistency4/5

    Most tools follow a clear verb_noun pattern (e.g., 'create_contacts', 'list_invoices'). Exceptions include 'authenticate' (no noun) and slight plural/singular inconsistency (e.g., 'create_bank_transactions' vs 'get_bank_transaction'), but overall the naming is predictable and readable.

    Tool Count5/5

    15 tools is well-scoped for a Xero API server covering core entities: authentication, bank transactions, contacts, invoices, accounts, organisations, payments, and quotes. Each tool addresses a necessary operation without excessive granularity.

    Completeness3/5

    The tool set provides basic CRUD for bank transactions and contacts, but lacks create for invoices, quotes, and payments, and omits delete/archive for any entity. This leaves notable gaps for full lifecycle management, though the domain is partially covered.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      A Model Context Protocol server implementation providing standardized access to Xero's accounting and business features, enabling operations like contact management, invoice creation, and chart of accounts management through MCP.
      51
      21,642 npm
      394
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An enhanced MCP server for Xero, enabling natural language interaction with your Xero organisation for accounting tasks like invoices, contacts, bank transactions, and payroll.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that enables AI assistants to read and write Xero accounting data, including invoices, contacts, accounts, and payments, through natural language.
      MIT