How to integrate Xero MCP with Atomic Agent

Connect Atomic Agent to Xero MCP. List all active xero tenant connections, show latest contacts added this week, and more using natural language, with authentication handled for you.

Xero logoXero
Oauth2

Xero is cloud-based accounting software for small businesses, offering invoicing, bookkeeping, and real-time financial reports. It helps you manage business finances efficiently from anywhere.

109 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Xero.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Xero account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Xero with

How Atomic Agent connects to Xero

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Xero to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Xero. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Xero account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Xero MCP server, and what's possible with it?

The Xero MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Xero account. It provides structured and secure access to your accounting data, so your agent can retrieve contacts, manage connections, update invoices, and retrieve quotes automatically on your behalf.

  • Connection management: Instantly list all active Xero tenant connections linked to your account, making it easy for your agent to select and operate on the right organization.
  • Contact retrieval and lookup: Fetch detailed, up-to-date lists of business contacts including filtering, paging, and incremental updates to keep your records synchronized and actionable.
  • Quote management and tracking: Retrieve, filter, or search through your sales quotes so your agent can help you stay on top of prospective business and follow up faster.
  • Invoice updating and automation: Modify details of existing invoices—such as amounts, due dates, and line items—allowing your agent to keep your invoicing accurate and up to date without manual edits.

Use Xero from Atomic Agent

With your account connected, ask Atomic Agent to work with Xero in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Xero action and event your agent gets out of the box.

Add Contacts to Contact Group

Add one or more existing contacts to an existing Xero contact group.

Add Invoice History Note

Append an audit-history note to an existing Xero invoice.

Add Manual Journal History Note

Append an audit-history note to an existing Xero manual journal.

Allocate Credit Note

Allocate part of an existing Xero credit note to an invoice.

Allocate Overpayment

Allocate part of an existing Xero overpayment to an invoice.

Bulk Create Bank Transactions

Create multiple Xero bank transactions with item-level validation results.

Bulk Create Invoices

Create multiple Xero invoices or bills.

Create Bank Transaction

Create a bank transaction in Xero.

Create Bank Transfer

Record a bank transfer between two bank accounts in a Xero organisation.

Create Batch Payment

Create one Xero batch payment containing one or more invoice payments.

Create Contact

Create a new contact in Xero.

Create Credit Note

Create a new credit note in Xero.

Create File Association

Associate a Xero file with an accounting object.

Create Invoice

Create a new invoice in Xero.

Create Item

Create an inventory item in Xero.

Create Manual Journal

Create a manual journal in Xero with journal lines.

Create or Update Account

Create a Xero chart-of-account record, or update one by account ID.

Create Payment

Create a payment in Xero to link an invoice with a bank account transaction.

Create Payroll Timesheet

Create a payroll timesheet with a documented Xero status in a Payroll AU organisation.

Create Purchase Order

Create a purchase order in Xero to order goods/services from suppliers.

Create Quote

Create a new sales quote in Xero for a customer or prospect.

Create Repeating Invoices

Create repeating invoice templates with schedules, approval/sent state, sender copies, and PDF attachments.

Create Tracking Option

Add an option to an existing Xero tracking category.

Delete Credit Note Allocation

Delete one allocation from an existing Xero credit note.

Delete Item

Permanently delete a Xero inventory item by its internal UUID.

Delete Payment

Set an existing Xero payment to DELETED by its internal UUID.

Download Attachment

Download an attachment from a supported Xero accounting entity.

Download File Content

Download the binary content of a Xero Files document.

Get Account

Retrieve a specific account from Xero's chart of accounts by its unique ID.

Get Asset

Retrieve a specific asset by ID from Xero.

Get Asset Settings

Retrieve numbering, depreciation, disposal, and tax settings for fixed assets.

Get Balance Sheet Report

Retrieve Balance Sheet report from Xero.

Get Bank Summary Report

Retrieve Xero's account-level Bank Summary for an optional date range.

Get Bank Transaction

Retrieve a specific spent or received money transaction from Xero by its unique bank transaction ID.

Get Bank Transfer

Retrieve one Xero bank transfer by its provider identifier.

Get Budget

Retrieve a budget from Xero.

Get Connections

Tool to list active Xero connections.

Get Contact Aged Report

Retrieve aged payables or receivables rows for one Xero contact.

Get Contact CIS Settings

Retrieve Construction Industry Scheme settings for a Xero contact.

Get Contact Group

Retrieve a specific Xero contact group and its current members.

Get Contact History

Retrieve activity history records for a Xero contact.

Get Contacts

Tool to retrieve a list of contacts.

Get Credit Note

Retrieve a specific credit note by ID from Xero.

Get Executive Summary Report

Retrieve Xero's Executive Summary financial report for an optional date.

Get File

Retrieve metadata for a specific file stored in Xero Files.

Get Invoice

Retrieve a specific invoice by ID from Xero.

Get Item

Retrieve a specific item by ID from Xero.

Get Manual Journal

Retrieve a specific manual journal by ID from Xero.

Get Online Invoice

Retrieve the hosted online-invoice URL for an authorised Xero invoice.

Get Organisation

Retrieve organisation details from Xero.

Get Payment

Retrieve a specific payment by ID from Xero.

Get Payroll Employee

Retrieve detailed Australian Payroll information for one Xero employee.

Get Payroll Payslip

Retrieve one Australian payroll payslip by its Xero payslip ID.

Get Payroll Settings

Retrieve Australian Payroll accounts, tracking, year, and STP2 settings.

Get Pay Run

Retrieve one Australian Xero payroll pay run and its payslips.

Get Profit & Loss Report

Retrieve a Xero Profit & Loss report showing income, expenses, and net profit; when both dates are supplied, their range cannot exceed 365 days.

Get Project

Retrieve a specific project by ID from Xero.

Get Purchase Order

Retrieve a specific purchase order by ID from Xero.

Get Quotes

Tool to retrieve a list of quotes.

Get Record History

Retrieve history for a Xero bank transaction, invoice, manual journal, or payment.

Get Repeating Invoice

Retrieve a Xero repeating invoice template by its unique ID.

Get Trial Balance Report

Retrieve Trial Balance report from Xero.

List Accounts

Retrieve Xero's chart of accounts, with optional filtering and ordering.

List Advance Payments

List filtered Xero overpayments or prepayments.

List Assets

Retrieve fixed assets from Xero by status, defaulting to DRAFT.

List Attachments

List all attachments for a specific entity in Xero (invoice, contact, etc.).

List Bank Transactions

Retrieve bank transactions from Xero.

List Bank Transfers

List transfers between bank accounts in a Xero organisation.

List Batch Payments

List Xero batch payments with documented filtering and ordering controls.

List Branding Themes

List the branding themes available in a Xero organisation.

List Budgets

List budgets from a Xero organisation with optional ID and date filters.

List Contact Groups

List Xero contact groups so their identifiers and names can be discovered.

List Credit Notes

Retrieve list of credit notes from Xero.

List Organisation Currencies

List currencies enabled for the connected Xero organisation.

List File Associations

List Xero business objects associated with a specific file.

List Files

Retrieve files from Xero Files.

List Folders

Retrieve folders from Xero Files.

List Invoices

Retrieve a list of invoices from Xero.

List Items

Retrieve items (inventory/products) from Xero.

List Journals

Retrieve journals from Xero, with optional modified-since and payment-only filters and offset pagination.

List Manual Journals

Retrieve manual journals from Xero.

List Payments

Retrieve list of payments from Xero.

List Payroll Calendars

List and filter calendars in a Xero Payroll AU organization.

List Payroll Employees

List Australian payroll employees with Xero filters and page selection.

List Payroll Leave Applications

List Xero Payroll AU leave applications, including requested leave.

List Payroll Pay Items

List earnings, deductions, reimbursements, and leave types in Payroll AU.

List Payroll Pay Runs

List and filter pay runs in a Xero Payroll AU organisation.

List Payroll Superfunds

List and filter superfunds in a Xero Payroll AU organisation.

List Payroll Timesheets

List and filter timesheets in a Xero Payroll AU organisation.

List Projects

Retrieve projects from Xero.

List Project Time Entries

List and filter time entries logged against a specific Xero project.

List Purchase Orders

Retrieve list of purchase orders from Xero.

List Quotes

Retrieve a list of sales quotes from Xero with optional filtering and pagination.

List Repeating Invoices

List Xero repeating invoice templates with optional filtering and ordering.

List Reports

List organisation-specific Xero reports that require a UUID to retrieve.

List Tax Rates

Retrieve tax rates from Xero.

List Tracking Categories

Retrieve tracking categories from Xero.

List Organisation Users

List users of the connected Xero organisation.

Update Invoice

Tool to update an existing invoice.

Update Bank Transaction

Update an existing bank transaction in Xero.

Update Contact

Update an existing contact in Xero.

Update Credit Note

Updates a specific credit note in Xero by its unique identifier.

Update Item

Update an existing Xero inventory item by its ItemID.

Update Manual Journal

Update an existing manual journal (journal entry) in Xero by its ID.

Update or Create Quotes

Create and update multiple Xero quotes in one collection request.

Update Purchase Order

Updates a specific purchase order in Xero by its unique identifier.

Update Quote

Updates a specific quote in Xero by its QuoteID.

Upload Attachment

Upload a file attachment to a Xero entity (invoice, contact, etc.).

Validate Credential

Check Xero credentials by querying connected organisations.

FAQ

Frequently asked questions

Start with Xero.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Xero tool your agent needs.Free to start.

Start building