How to Use the Xero MCP in Windsurf

Q: Can I get organizational details for Xero using Windsurf?

Absolutely. The getorganisationinfo tool pulls basic setup data about your Xero account. This is great for quick validation checks before starting a larger, more complex reporting flow.

Automate complex accounting tasks with Windsurf: Run full Xero financial reports without manual steps.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Xero MCP to Windsurf

Create your Vinkius account to connect Xero to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Xero with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate Full P&L Reports

You can run `get_profit_and_loss` to build a time-bound financial view. Just provide the required start and end dates, and Cascade returns the full Profit and Loss report for that period. This makes multi-step reporting simple. Need to check P&L against current assets? Windsurf handles the sequence automatically, pulling data from `get_balance_sheet` right after.

List All Financial Documents

The `list_xero_invoices` tool retrieves every sales and purchase invoice in your Xero organization. This is perfect for compliance checks or audit preparation. Don't just list them, though. You can follow up by calling `get_invoice_details` on a specific ID to pull line-item breakdowns, giving you the full picture of what that transaction covered.

Track Bank Activity and Payments

`list_bank_transactions` grabs every single transaction recorded in your linked bank accounts. It gives you a raw feed to work with. For reconciliation, Windsurf can chain this data by listing payments using `list_xero_payments`. This sequence lets you compare incoming funds against the actual invoices paid.

Setup guide

Set up Xero MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Xero MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Xero payment history." If connected, Cascade will call the Xero tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "xero-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Xero. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Xero now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Xero MCP in Windsurf

You set a goal: 'Reconcile last month's bank statement.' The Windsurf agent sees that you need to compare transactions. It automatically calls `list_bank_transactions` and then uses the dates found there to pull matching data from `list_xero_invoices` via the MCP Server.

Yes. The Windsurf agent respects your data boundaries. When using the MCP Server, it only accesses the necessary metadata—like `list_xero_contacts` or transaction dates—and never shares raw credentials.

Absolutely. The `get_organisation_info` tool pulls basic setup data about your Xero account. This is great for quick validation checks before starting a larger, more complex reporting flow.

You can build anything that needs multiple steps. For example, you could get the `get_balance_sheet` first, then use those totals to check against data pulled by `list_chart_of_accounts` for a cross-check.

The MCP Server manages time ranges. For reports like P&L, you specify the start and end dates right in the request to `get_profit_and_loss`. The system handles retrieving records from that specific window.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript