Connect your AI Agents to Xero in minutes

What is a Xero MCP?

A Xero MCP is an MCP server that gives your agents access to data and functionality inside your Xero organization via tools. Your agents can invoke these tools to create and update invoices, record payments, manage contacts, post journal entries, and more.

Xero offers an official MCP server, but you can also use one from a third-party platform, like Merge Agent Handler.

How can I use the Xero MCP server?

The use cases naturally depend on the agent you've built, but here are a few common ones:

• Invoice automation: When a project milestone is marked complete in a project management tool, an agent creates a draft invoice in Xero for the relevant contact and emails it to the client without any manual step in between

• Payment reconciliation: An agent monitors incoming bank transactions in Xero, matches them against outstanding invoices by amount and reference, and applies payments automatically to keep the books current

• Cross-system expense posting: When expense reports are approved in an expense management tool, an agent creates the corresponding bank transactions and manual journal entries in Xero, eliminating double entry

• Accounts receivable reporting: An agent queries Xero for overdue invoices and outstanding balances on a weekly schedule, formats the results, and posts a summary to a Slack channel for the finance team to review

What are popular tools for Xero's MCP server?

Here are some of the most commonly used tools:

• create_invoice: creates a new invoice in Xero for a given contact, line items, and due date. Use this when an agent needs to bill a client automatically after a trigger event in another system

• list_invoices: retrieves invoices filtered by status, contact, or date range. Helpful when an agent needs to identify outstanding or overdue invoices before taking a collection or reporting action

• create_payment: records a payment against an invoice or credit note in Xero. Call this when an agent detects an incoming payment in a bank feed or payment processor and needs to reconcile it automatically

• create_contact: adds a new customer or supplier to Xero's contact list. Good for workflows that onboard a new client in a CRM and need to mirror that record in Xero without manual data entry

• create_bank_transaction: posts a spend or receive money transaction against a bank account in Xero. Call this when an agent processes an approved expense or reimbursement and needs to record it in the ledger

• create_manual_journal: creates a manual journal entry with debit and credit lines. Useful for agents that handle month-end adjustments or intercompany postings triggered by events in another financial system

What makes Merge Agent Handler's Xero MCP server better than alternative Xero MCP servers?

Several factors make Merge Agent Handler's Xero MCP server the stronger choice over building or using an alternative:

• Enterprise-grade security and DLP: Merge Agent Handler includes built-in data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For Xero, this means you can prevent invoice amounts, bank account details, and contact financial data from being exposed even when the agent has broad read access

• Managed authentication and credentials: Merge stores and refreshes Xero credentials on your behalf. You never expose raw OAuth tokens or client secrets to an agent or manage the token rotation cycle manually

• Real-time observability and audit trail: Every tool call made against Xero is logged with timestamp, tool name, input parameters, and response metadata. Finance teams can audit exactly what an agent created or modified without instrumenting anything themselves

• Tool Packs and controlled access: Tool Packs let you bundle specific Xero tools with tools from other connectors into a single MCP endpoint, scoped to a specific use case. An agent built for invoice creation doesn't need access to journal entries or bank transactions

How can I start using Merge Agent Handler's Xero MCP server?

You can take the following steps:

1. Create or log into your Merge Agent Handler account and navigate to Tool Packs (collections of connector tools scoped to a specific use case).

2. Create a new Tool Pack, then find and enable the Xero connector. Choose which tools to include: enable read tools for reporting and reconciliation use cases, or add write tools if your agent needs to create invoices, record payments, or post journal entries.

3. Add a Registered User inside the Tool Pack. This is the identity context under which your agent operates. Merge generates a unique MCP URL scoped to this user once it's created.

4. From the Registered User detail page, authenticate Xero by completing the OAuth flow. Merge stores and manages the credentials going forward.

5. Copy the MCP URL from the Tool Pack detail page and generate an API key from Settings. You'll need both to connect your agent.

6. Add the MCP server to your agent or IDE using the MCP URL and API key. Your Xero tools are now accessible through that endpoint.