MCP server guide · reviewed by Pravin Bansal, Co-founder & CEO on November 19, 2026

Xero MCP server

Yes, Xero has official MCP servers. As of November 2026, Xero offers its own connectors for Claude, ChatGPT and Microsoft 365 Copilot that answer questions from live Xero data (read-only in Claude and Copilot), and a Developer Remote MCP Server at https://api.xero.com/mcp/v1, generally available since October 13, 2026, with 39 read and write tools for developer apps on the Core plan or above. Xero also keeps an open-source server that runs locally. The remote server’s write tools do not ask the user to confirm, so invoices, payments and manual journals under your own approval and posting rules need a confirmation step in your agent, a hosted platform or a custom server on the Xero API.

Official server: Yes, generally available
As of November 2026, Xero's own connectors for Claude and Microsoft 365 Copilot are read-only and it has a plugin in ChatGPT, while its Developer Remote MCP Server (api.xero.com/mcp/v1, generally available Oct 13, 2026) gives developer apps 39 read and write tools, including invoices, payments and manual journals, under OAuth with PKCE; it is included for Commercial Apps on the Core plan or above.

Building a product that needs Xero access? Our custom MCP development service covers customer permissions, client testing, deployment and engineering handover.

Without a build, mcpbizapps, AIONDATA’s governed MCP gateway, lists Xero among its 294 apps and sets it up for your team in a guided pilot: roles per tool, a preview before every change, approval above a set amount and an audit log.

Xero API facts that shape an MCP server

Xero API facts that shape an MCP server
FactDetailSource
Developer Remote MCP ServerXero hosts the Developer Remote MCP Server at https://api.xero.com/mcp/v1, where an MCP client calls tools that read and write accounting data in the organisations connected to your app. Xero recommends its OAuth 2.0 flow with PKCE, each call runs against one organisation, and access is included for Commercial Apps on the Core plan or above, with Starter apps limited to a demo organisation.Xero Developer: Developer Remote MCP overview
General availabilityXero announced general availability on October 13, 2026 with 39 tools, the catalogue its closed beta ran on, and says more are in the pipeline. There is no separate fee on Core and above, tool calls count as API calls, and because the server signs in through a standard PKCE app it is available everywhere, unlike custom connections.Xero Developer blog: The Xero Remote MCP now generally available (October 13, 2026)
Tools and scopesThe 39 tools cover invoices, credit notes, quotes, items, contacts, bank transactions, payments, manual journals, tracking categories, accounts, tax rates and five reports: profit and loss, balance sheet, trial balance, aged receivables and aged payables. Twenty-one of them write, including create_payment, create_manual_journal, authorise_invoice and void_invoice, and each tool needs its own granular scope, such as accounting.invoices.read.Xero Developer: Developer Remote MCP overview, Tools
No built-in confirmationXero’s Remote MCP FAQ says the version 1 tools do not ask the user to confirm before changing data, and tells developers to have the agent confirm before writing anything back to Xero. Only the API calls are logged in the Developer Portal, not the tool calls or prompts behind them, and custom connection apps cannot use the Remote MCP Server.Xero Developer: Remote MCP FAQ
Claude connectorXero is an Anthropic-verified connector in Claude’s directory, made by Xero Limited and added in April 2026, at https://mcp.xero.com/mcp. The listing shows 20 tools, such as get_profit_and_loss, get_cash_position, get_aged_receivables, get_bills and get_bank_account_transactions, and says Claude connects with read-only access.Claude directory: Xero connector
What the Claude connector allowsXero says the connector is read-only and follows your Xero permissions: Claude can’t create, edit, approve, reconcile or pay in Xero, and it reads uncoded transactions and draft invoices too. It is free to add and needs an active Xero subscription and a Claude account on a free or paid plan.Xero: Claude connector
ChatGPT pluginOn September 16, 2026 Xero said its plugin in ChatGPT was live, first announced at Xerocon US and powered by JAX, for use across Chat, Work and Codex with real-time Xero data such as profit and loss, balance sheet, invoices and bills. The same post says the Claude integration launched in May and that Xero’s Microsoft 365 connections would soon include Excel, Word, PowerPoint and Copilot Cowork.Xero blog: Xero wherever you work, Claude for Small Business and ChatGPT (September 16, 2026)
Microsoft 365 CopilotXero’s agent in Microsoft 365 Copilot is read-only at launch and is added from the agent store, with an active Xero subscription and a paid Microsoft 365 Copilot licence on a Business or Enterprise plan. Xero’s page describes Copilot Studio and the Xero MCP server as developer build tools.Xero: Microsoft 365 Copilot connector
Open-source serverXero’s repository XeroAPI/xero-mcp-server is a local server under the MIT licence, run through npx as @xeroapi/xero-mcp-server (version 0.0.18). Its README lists 51 commands, including payroll employee, leave and timesheet commands, and two sign-in modes: a custom connection’s client ID and secret, or a bearer token for clients that run their own OAuth flow.GitHub: XeroAPI/xero-mcp-server
MCP RegistryOn November 19, 2026 a search for xero in the official MCP Registry returned 13 entries, none published under a Xero namespace, so Xero’s own servers are not listed there. Third-party entries include com.pilot.meridian/xero-connector, com.kipper/xero and nz.co.invio/xero.Official MCP Registry: search for xero
API rate limitsEach app may make 60 calls a minute and 5 concurrent calls per connected organisation, with a daily limit of 1,000 calls per organisation on the Starter tier and 5,000 on higher tiers, plus 10,000 calls a minute across all organisations. A call over a limit gets HTTP 429, and for the minute and daily limits a Retry-After header says how many seconds to wait.Xero Developer: OAuth 2.0 API limits
Developer plansAs of November 2026 Xero’s developer plans are Starter (no charge, 5 connections), Core ($35 AUD a month, 50 connections, 10 GB of data egress), Plus ($245 AUD, 1,000 connections, 50 GB), Advanced ($1,445 AUD, 10,000 connections, 250 GB) and Enterprise (price on application), before tax. Egress above the allowance costs $2.40 AUD per GB, and the Remote MCP Server is listed for every plan, on Starter with a demo organisation only.Xero Developer: Pricing and Policies
Granular scopesXero is replacing broad scopes such as accounting.transactions and accounting.reports.read with granular ones such as accounting.invoices, accounting.payments, accounting.banktransactions and accounting.manualjournals. Web and PKCE apps have been assigned granular scopes since March 2026 and custom connections since April 29, 2026, and broad scopes remain available until September 2027.Xero Developer: OAuth 2.0 scopes

Every way to connect Xero to AI

Every way to connect Xero to AI
OptionTypeFits whenLimits
Xero’s connectors for Claude, ChatGPT and Microsoft 365 CopilotOfficialOwners, accountants and bookkeepers who want answers on profit, cash, receivables, payables, invoices and top customers from live Xero data, with links back to Xero, nothing to host and no developer app to register.Read-only in Claude and, at launch, in Microsoft 365 Copilot: no creating, editing, approving, reconciling or paying. Xero’s ChatGPT announcement describes questions, insights and workflows and no write actions. The tools are Xero’s, and the Copilot agent needs a paid Microsoft 365 Copilot licence.
Xero Developer Remote MCP ServerOfficialDevelopers and builders with a Xero PKCE app who want 39 hosted read and write tools, including invoices, payments, bank transactions and manual journals, across several organisations with each user’s consent. Xero documents setup for Claude Desktop, Claude Code, Cursor and VS Code.Real organisations need a Commercial App on the Core plan or above, and custom connection apps are not eligible. The tools do not ask for confirmation before writing, Xero logs only the API calls, and the published list has no purchase order, repeating invoice or payroll tools.
Xero’s open-source MCP server (local)OfficialA developer or single bookkeeper who wants 51 commands, including payroll timesheets, in Claude Desktop or another local client, tested for free against the demo company. MIT licence.Runs on one machine that you install and update. The usual setup is a custom connection, which covers one organisation, needs a monthly subscription for a real organisation and is offered only in Australia, New Zealand, the UK and the US. Still version 0.0.18.
Meridian Connector for Xero (Pilot)HostedAccounting firms and finance teams that want write access from Claude: 75 tools, several Xero companies on one agent, and read-only or read-write access chosen per company. Anthropic-verified in Claude’s directory since August 2026.A third-party service, so data passes through Pilot. Its tools can create arbitrary transactions, including journal entries, and approve invoices, so set companies to read-only where you can and keep your own approval rules. The listing shows no pricing.
Composio Xero toolkitHostedDevelopers building agents for Claude, ChatGPT or Cursor who want 107 Xero tools, from reports and contacts to purchase orders, batch payments and Australian payroll lookups, with token refresh handled for them.You still register your own Xero OAuth app and add its client ID and secret to Composio, so Xero’s developer plans and limits apply. The catalogue includes bulk invoice creation and deleting payments, so allowlist tools before connecting an assistant, and data passes through Composio.
Custom Xero MCP serverCustomReceivables, payables and month-end tools with your posting and approval rules, purchase orders, several organisations with different permissions per person, such as an accounting practice’s clients, or Copilot Studio, hosted in your own cloud.Needs a Xero developer app on a plan that covers your connections and data egress, careful token handling and upkeep as Xero moves to granular scopes. Check first whether the Remote MCP Server with a confirmation step in your agent already does the job.

Tools a Xero MCP server should expose

Start with read-only tools and add write actions once the team trusts the answers. Every write action below runs with a confirmation or approval step.

Tools a Xero MCP server should expose
ToolAccessRiskPurposeGuard
find_contactReadLowLook up a customer or supplier by name, email or account number, with outstanding and overdue balances.Allowlisted fields only; no bank account details; the model can’t send free-form filters.
list_overdue_invoicesReadLowOverdue sales invoices by contact, with amount due and days late.Read-only on the accounting.invoices.read scope; fixed filters on type, status and due date; paged 100 at a time.
list_bills_dueReadLowUnpaid bills due in the next N days, by supplier and due date.Read-only; supplier names, amounts and dates only, no supplier bank details.
get_aged_balancesReadLowAged receivables or aged payables for a contact as at a date, by aging bucket.Read-only on the accounting.reports.aged.read scope; a contact is required, as Xero’s aged reports run per contact.
get_profit_and_lossReadLowProfit and loss for a period, with a prior-period comparison and tracking categories.Read-only on the accounting.reports.profitandloss.read scope; finance roles only; date range capped at 12 months.
list_bank_transactionsReadMediumSpend and receive money transactions for a bank account and date range.Owner or finance role only; account names and codes, never bank account numbers; paged.
create_draft_invoiceWriteMediumBuild a sales invoice from contact, items and quantities and show lines, tax and total before saving.Names the organisation, then saves as a draft only after the user confirms the preview; it doesn’t approve or email the invoice, and an idempotency key stops a retry creating a duplicate.
record_invoice_paymentWriteHighRecord a payment against an approved invoice or bill from a named bank account.Amount checked against the amount due; approval by an accounts role; idempotency key; refused for dates on or before the lock date.
create_manual_journalWriteHighCreate a manual journal with balanced debit and credit lines and a narration.Saved as a draft with a preview of every line; posting needs approval by a finance approver; refused for dates on or before the lock date; logged with user, organisation and journal ID.

Connect Xero to Claude, ChatGPT or Copilot Studio

Claude

Xero’s own connector is in Claude’s directory (Anthropic-verified, made by Xero Limited): add Xero, sign in with your Xero login and choose the organisation. It is read-only and works with free and paid Claude plans. For writes, Xero documents its Developer Remote MCP Server for Claude Desktop and Claude Code, using your PKCE app’s client ID, and its open-source server runs locally in Claude Desktop through npx. A hosted or custom Xero server is added as a custom connector, and on Team and Enterprise plans an Owner adds it first. Calls come from Anthropic’s cloud, so a private server must allowlist Anthropic’s IP ranges.

ChatGPT

Xero’s plugin in ChatGPT went live on September 16, 2026; Xero says it is powered by JAX and works across Chat, Work and Codex with real-time data such as profit and loss, balance sheet, invoices and bills. Xero’s Remote MCP setup guides cover Claude Desktop, Claude Code, Cursor and VS Code, not ChatGPT, so test before relying on it there. A hosted or custom server needs developer mode (on Enterprise and Education an admin grants access) and is added under ChatGPT Plugins over Streamable HTTP with OAuth, with Xero tokens kept on the server. ChatGPT asks for confirmation on tools without a readOnlyHint, so mark reads read-only and let writes ask.

Microsoft Copilot Studio

Xero’s own Microsoft offer is the Xero agent in Microsoft 365 Copilot, announced July 1, 2026: read-only at launch, added from the agent store, and it needs a paid Microsoft 365 Copilot licence on a Business or Enterprise plan. Xero calls Copilot Studio and the Xero MCP server developer build tools and has no Copilot Studio setup guide for its Remote MCP Server, so test that pairing first. Add a hosted or custom server with the MCP onboarding wizard on the agent’s Tools page (Streamable HTTP only; OAuth 2.0, API key or none) and turn on generative orchestration. Microsoft Learn also lists a third-party premium connector, Xero Accounting - Magnetism (preview), with create, update, delete and list actions, its own licence and 100 calls per connection per minute. Power Platform data policies govern both routes.

Claude implementation · Copilot implementation · ChatGPT implementation

Permissions, identity and audit

  • Xero’s connectors for Claude and Microsoft 365 Copilot are read-only, follow the signed-in person’s Xero permissions and reach only the organisations that person connects. Decide who may connect them, since Claude reads uncoded transactions and draft invoices as well as finished reports.
  • On the Developer Remote MCP Server an agent can call only the tools whose scopes your app holds and the user approved. Request granular scopes per tool, such as accounting.invoices.read or accounting.reports.profitandloss.read; scopes are additive, and the only way to reduce them is to revoke the token and connect again.
  • One user can connect several organisations to the same app and each call runs against one of them, so map every signed-in person to the organisations and tools they may use, and have the agent name the organisation before any write.
  • Access tokens last up to 30 minutes and refresh tokens up to 60 days. Each refresh returns a new refresh token, with a 30-minute grace period for the old one, so keep tokens server-side in a secrets manager and always store the newest. A PKCE app has no client secret to leak into a prompt or configuration file.
  • A custom connection uses the client credentials grant for a single organisation, so everyone using a server built on it shares one set of scopes. Keep it for one person or a background job, and enforce roles in your own server.
  • Xero’s remote tools do not ask for confirmation and Xero logs only the API calls, so give each write tool a preview, confirmation by a person whose role covers that document, an idempotency key and a lock-date check, and log the user, tool, organisation and record IDs yourself.

Hosting and network

  • Xero hosts its Claude connector (mcp.xero.com/mcp) and the Developer Remote MCP Server (api.xero.com/mcp/v1), so there is nothing to deploy. The remote server needs a PKCE app in the Xero Developer portal with a redirect URL that matches your MCP client.
  • Xero’s open-source server runs on the user’s machine through npx (Node.js 18 or higher), with the client ID and secret or a bearer token in the client’s configuration. That suits a developer or a single bookkeeper, not a shared team service.
  • A custom server runs in your AWS or Azure account behind Streamable HTTP and OAuth, with refresh tokens in a secrets manager, calling api.xero.com over HTTPS with a xero-tenant-id header for the organisation. Claude and ChatGPT reach it from their own clouds, so publish it behind authentication or use ChatGPT’s Secure MCP Tunnel.
  • Queue calls per organisation to stay under 5 concurrent and 60 a minute, wait for the Retry-After time on an HTTP 429, and page invoices, contacts and bank transactions 100 at a time. Build against the demo company, which resets 28 days after creation, so the app must be reconnected.

Cost and timeline

  • Xero doesn’t charge for its Claude or Microsoft 365 Copilot connectors. You need an active Xero subscription plus a Claude account (free or paid) or a paid Microsoft 365 Copilot licence.
  • As of November 2026 the Developer Remote MCP Server carries no separate fee: it is included for commercial apps on Core ($35 AUD a month before tax, 50 connections, 10 GB of data egress) and above, and Starter apps can use it with a demo organisation for free. Xero says accountants and bookkeepers building for their own practice or a client can apply for an API fee exemption that includes MCP access. Custom connections need their own monthly subscription per organisation.
  • A focused read-only Xero MCP server typically takes two to four weeks including security and evaluation.
  • Write tools (invoices, payments, bills, manual journals), several organisations, or an ERP or CRM alongside Xero take longer and are scoped after a short discovery. Hosted platforms price on their own terms; Unified.to and CData offer free trials (Unified.to states 30 days).

Xero MCP questions

Does Xero have an MCP server?

Yes. As of November 2026 Xero hosts a Developer Remote MCP Server at https://api.xero.com/mcp/v1 (generally available October 13, 2026) with 39 read and write tools for developer apps, and offers its own connectors for Claude, ChatGPT and Microsoft 365 Copilot for business users. It also publishes an open-source server on GitHub that runs locally. None of them appears in the official MCP Registry, whose Xero entries all come from third parties.

How do I connect Claude to Xero?

For read-only answers, add the Xero connector from Claude’s connectors directory, sign in with your Xero login and choose the organisation; Xero says it is free to add and works with free and paid Claude plans. For write access, create a PKCE app in the Xero Developer portal and add https://api.xero.com/mcp/v1 to Claude Desktop or Claude Code as a remote server, which needs the Core plan or above for a real organisation. Xero’s open-source server is a third route for one person on one machine.

Can an AI assistant create invoices or post manual journals in Xero?

Not through Xero’s Claude or Microsoft 365 Copilot connectors, which are read-only. Yes through the Developer Remote MCP Server, which has create_invoice, authorise_invoice, void_invoice, create_payment and create_manual_journal among its 21 write tools. Xero says those tools do not ask the user to confirm, so the confirmation has to come from your agent or from a custom server that shows a preview, checks the lock date and asks the right person first.

Does Xero work with ChatGPT and Microsoft Copilot?

Yes for questions. Xero’s plugin in ChatGPT has been live since September 16, 2026, and its agent in Microsoft 365 Copilot, announced July 1, 2026, is read-only at launch and needs a paid Microsoft 365 Copilot licence. Xero has not published setup guides for its Remote MCP Server in ChatGPT developer mode or Copilot Studio, so test first; a hosted or custom Xero MCP server with OAuth can be added to both over Streamable HTTP.

What does a Xero MCP server cost, and which API limits apply?

Xero’s connectors are free to add on top of a Xero subscription. As of November 2026 the Remote MCP Server is included for commercial apps on the Core plan ($35 AUD a month before tax) or above, with tool calls counted as API calls and returned data counted toward the plan’s egress allowance. Every route is bound by the API limits: 60 calls a minute and 5 at a time per organisation, and 5,000 a day per organisation on Core and above (1,000 on Starter).

Is Xero’s open-source MCP server still worth using?

For one developer or bookkeeper, yes. It has 51 commands, including payroll employee, leave and timesheet commands that the remote server’s published list lacks, and it can be tested for free against the demo company. The usual setup is a custom connection, which covers one organisation, needs a monthly subscription for a real one and is available only in Australia, New Zealand, the UK and the US. Xero says the local server keeps working and points anyone sharing access or working across organisations to the Remote MCP Server.

What are the alternatives to Xero’s own servers?

In Claude’s directory, the Meridian Connector for Xero from Pilot offers 75 tools with read-only or read-write access per company. Composio lists 107 Xero tools but has you register your own Xero OAuth app, Pipedream exposes its 39 Xero actions as MCP tools on a remote server, and Zapier lets you choose which Xero actions an assistant may run. Unified.to and CData Connect AI also offer hosted MCP access to Xero. All of them call the Xero API, so its limits still apply.

Should we use Xero’s server or build our own?

Use Xero’s connectors if read-only answers in Claude, ChatGPT or Microsoft 365 Copilot are enough, and the Developer Remote MCP Server if its 39 tools fit your process and your agent confirms every write. Build a custom server when you need approval and posting rules enforced on the server, purchase orders or payroll, different permissions per person across several organisations, or tools that span Xero and other systems. AIONDATA is independent and not a Xero partner, so we will tell you when the official server is the better choice.

Connect Xero to your AI assistants.

Tell us which Xero questions and actions matter. We’ll say whether the official route is enough and scope a custom server where it isn’t.

Please share the workflow and the systems involved—not credentials or employee or customer records.

AIONDATA colleagues gathered in front of arched windows during a team outing.The people behind the work.Get to know our team and life at AIONDATA. Meet the team
NVIDIA Inception

NVIDIA Inception member

Part of NVIDIA’s program for startups building with AI and accelerated computing.

About the program
Pravin BansalSravan Modugula

Bay Area roots. Enterprise experience.

Pravin’s experience includes Google and SmartBear. Sravan previously held leadership roles at JPMorgan Chase and First Republic Bank.

Meet the founders

San Francisco Bay Area, California

9110 Alcosta Blvd Ste H345, San Ramon, CA 94583

US-led delivery, with engineering in India. Supporting US and international organizations.
Prefer email? info@aiondata.io

Scope your Xero MCP server.

Just your name and email to get started. Your details are handled under our Privacy Policy.

Prefer email? info@aiondata.io