Integrations · Accounting

Connect Xero to Well

Well forwards extracted invoice PDFs to your Xero email-in address; Xero creates a draft bill with contact, dates, totals, line items, and tax type via Hubdoc. Xero's bank feeds combine with Well's multi-source capture for full reconciliation.

What flows between Well and Xero

Well writes reconciled draft bill, contact, attachment back to Xero after they clear your review queue, with the source-record link preserved. Use Xero as the destination for entries enriched across your other connected tools.

From XeroIn Well
Invoice
Receivable
Bill
Payable
Contact
Vendor or customer
Bank transaction
Ledger line
Xero logo
Sync mode
MCP hybrid
Refresh
live + reconciliation reads
Direction
Xero ⇄ Well

12 triggers and actions in Xero.

  • When a Xero invoice is read

    Pulls Xero sales and purchase invoices with contact, line items, totals, and tax.

    Trigger·Invoice
  • When a Xero bank transaction is read

    Captures spent and received money transactions reconciled in Xero with amount and account code.

    Trigger·Transaction
  • When a Xero contact is read

    Pulls Xero contacts with name, trading address, and tax number to match against your companies.

    Trigger·Company
  • When a Xero bank account is read

    Pulls the bank-type accounts from the Xero chart of accounts with currency and account number.

    Trigger·Account
  • When a Xero invoice attachment is read

    Picks up the source PDF attached to a Xero invoice as a document.

    Trigger·Document
  • When a Xero payment is read

    Reads the payment applied to a Xero invoice or bill with method, account, and amount.

    Trigger·Payment method
  • When a Xero credit note is read

    Captures Xero credit notes with contact, totals, and tax so refunds reconcile against the original invoice.

    Trigger·Invoice
  • When a Xero purchase order is read

    Pulls Xero purchase orders with supplier, line items, and totals to match against the arriving bill.

    Trigger·Invoice
  • Create a draft bill in Xero

    Well forwards the PDF to your Xero email-in address; Xero creates a draft bill via Hubdoc with contact, dates, totals, line items, and tax type pre-filled. You review and post.

    Action·Invoice

What Well does with your Xero connection

Connect

Connect Xero over OAuth (MCP DCR via Well): Well registers a client through Xero's OAuth Dynamic Client Registration and you approve on Xero's side, so the password never reaches Well; Well holds only a scoped token it can refresh.

Sync

Well brings invoice, bill, and contact in from Xero on live events backed by periodic reconciliation reads. The first sync backfills history in the background and the connection stays live after.

Enrich

Well resolves each Xero entity into receivable, payable, and vendor or customer, assigns categories, and links every record to an audit trail across the rest of your connected tools.

Available

Your data from Xero lands as receivable, payable, and vendor or customer you can search, chart, and automate, and approved records flow back to Xero once they clear your review queue.

Questions Xero unlocks

Ask in plain language. Well answers from your connected Xero connection, resolved against the rest of your stack.

Ask Well

Ask anything about your Xero connection

Summarise this month
What needs attention?
Find unmatched records

Ask about your Xero connection…

Connect Xero in three steps

  1. 01

    Connect Xero for reading, and point Well at email-in for bills

    Connect Xero from Well's Connections panel. The read side runs through Well's hosted Xero MCP server, which registers via Dynamic Client Registration against Xero's OAuth, so you approve read scopes on Xero's screen. For the write side, give Well your Xero email-in address, which is where extracted bill PDFs are forwarded.

    • AuthOAuth (MCP DCR via Well)
    • ReadMCP server
    • WriteXero email-in (Hubdoc)
  2. 02

    Map your entities

    On the read path Well brings in invoices, bills, contacts, and bank transactions and maps each through its data-views layer; an invoice becomes a receivable, a bill a payable, a bank transaction the ledger line it matches.

    • Mappingpreconfigured by Well
  3. 03

    Use the data

    On the write path Well forwards an extracted PDF to your Xero email-in address and Hubdoc drafts a bill with the contact, dates, totals, line items, and tax type for you to review and post inside Xero. Direct journal posting through Xero's API is on the roadmap, not shipped, so today the draft bill is the write path.

    • First syncstarts as soon as connect completes

The read handshake completes in about a minute and older records backfill in the background. Email-in drafts appear in Xero shortly after Well forwards each PDF; you always post them yourself.

How Xero stays secure with Well

Reading from Xero runs through Well's hosted MCP server, where OAuth Dynamic Client Registration keeps your Xero credential out of Well and scopes the token to invoices, bills, contacts, and bank transactions. The only thing Well sends back is an extracted PDF to your Xero email-in address, which Hubdoc turns into a draft bill you review. Your ledger is never written automatically; the read side is read-only and the write side stops at a draft you approve.

OAuth (MCP DCR via Well)Encrypted at restGDPR compliant
Read the full privacy and security policy
Scopes Well requestsapi.wellapp.ai/v1/mcps/xero/mcp
  • Read Xero records

    Resources the Xero MCP server exposes, scoped by your OAuth approval.

    granted
  • Resolve invoice, bill, contact, and bank transaction across your stack

    Match identifiers in Xero against the same entities your other connected tools expose, so each record carries cross-tool context.

    granted
  • Deliver documents to your Xero inbox

    Well forwards approved documents to your Xero email-in address; Xero drafts the record and you post it. No write credential to Xero is requested.

    granted
  • Store Xero passwords or session cookies

    Authentication runs through OAuth (MCP DCR via Well) tokens we never see.

    refused
Disconnect any time from Well settings or Xero’s admin panel.

Frequently asked questions about Xero and Well

Open Connections in Well and connect Xero. The read side runs through Well's hosted Xero MCP server, which registers itself via Dynamic Client Registration against Xero's OAuth so you only approve scopes on Xero's screen. The write-back side uses your Xero email-in address rather than a second login, so one connect step covers both reading from Xero and forwarding bills into it.

Well reads invoices, bills, contacts, bank transactions, and their attachments. An invoice becomes a receivable, a bill becomes a payable, a contact resolves to the vendor or customer it represents, and a bank transaction lines up as the ledger line it matches. Two reads stay deliberately off the table: Xero org-login users are not treated as people, and tracking categories are not folded into your chart of accounts.

Well forwards the extracted PDF to your Xero email-in address, and Hubdoc on Xero's side reads it into a draft bill carrying the contact, dates, totals, line items, and tax type, with the source PDF attached. You review and approve the draft inside Xero. Direct ledger or journal posting through Xero's API from Well is on the roadmap rather than shipped today, so the email-in draft is the honest write path right now.

Yes. Well keeps both the original currency and the converted amount on a Xero record, so a euro-reporting business reading USD or GBP invoices sees the raw line and the converted line side by side. Reconciling against a deposit in the settlement currency then works without anyone redoing the foreign-exchange math by hand.

Well reads Xero through the MCP connection and refreshes invoices, bills, and bank transactions as they change, with the first connect backfilling earlier records in the background. On the read path Xero stays untouched, and on the write path Well only ever creates a draft bill for you to review, so Xero remains the system of record and your ledger is never changed without your approval.

Disconnect Xero in Well and the read connection revokes its token and stops calling the MCP server at once. Already-read invoices, bills, and contacts remain in your workspace for reporting. The email-in path simply stops receiving forwarded PDFs from Well; any draft bills Hubdoc already created live inside Xero and are unaffected, so disconnecting never strands a document mid-flight.

Xero logo

Ready to connect Xero?

Connect once. Every invoice, bill, contact from Xero becomes searchable, queryable, and ready for your agents and tables. Disconnect any time.