{"componentChunkName":"component---src-templates-doc-doc-container-tsx","path":"/documentation/guides/remote-mcp/overview/","result":{"data":{"site":{"siteMetadata":{"title":"Xero Developer"}}},"pageContext":{"picklist":[{"label":"Getting started","id":"dxt-menu__pick-list__id--getting-started-guide","href":"/documentation/getting-started-guide"},{"label":"Development accounts","id":"dxt-menu__pick-list__id--development-accounts","href":"/documentation/development-accounts"},{"isCollapsible":false,"heading":"SDKs and tools","id":"sdks-and-tools","items":[{"isCollapsible":true,"isOpen":false,"heading":"Libraries","id":"libraries","items":[{"label":"Overview","id":"dxt-menu__pick-list__id--sdks-and-tools-libraries-overview","href":"/documentation/sdks-and-tools/libraries/overview"}]},{"isCollapsible":true,"isOpen":false,"heading":"Tools","id":"tools","items":[{"label":"Overview","id":"dxt-menu__pick-list__id--sdks-and-tools-tools-overview","href":"/documentation/sdks-and-tools/tools/overview"},{"label":"Insomnia","id":"dxt-menu__pick-list__id--sdks-and-tools-tools-insomnia","href":"/documentation/sdks-and-tools/tools/insomnia"},{"label":"Postman","id":"dxt-menu__pick-list__id--sdks-and-tools-tools-postman","href":"/documentation/sdks-and-tools/tools/postman"},{"label":"Linx","id":"dxt-menu__pick-list__id--sdks-and-tools-tools-linx","href":"/documentation/sdks-and-tools/tools/linx"}]}]},{"isCollapsible":false,"heading":"Best Practices","id":"best-practices","items":[{"isCollapsible":true,"isOpen":false,"heading":"Overview","id":"overview","items":[{"label":"Matrix","id":"dxt-menu__pick-list__id--best-practices-overview-cert-matrix","href":"/documentation/best-practices/overview/cert-matrix"}]},{"isCollapsible":true,"isOpen":false,"heading":"Managing connections","id":"managing-connections","items":[{"label":"Designing and Implementing Xero Connection Cleanup Routine","id":"dxt-menu__pick-list__id--best-practices-connections-designing-and-implementing-connection-cleanup-routine","href":"/documentation/best-practices/managing-connections/designing-and-implementing-connection-cleanup-routine"},{"label":"Identifying inactive connections","id":"dxt-menu__pick-list__id--best-practices-connections-identifying-inactive-connections","href":"/documentation/best-practices/managing-connections/identifying-inactive-connections"},{"label":"Connections","id":"dxt-menu__pick-list__id--best-practices-connections-managing-connections","href":"/documentation/best-practices/managing-connections/connections"},{"label":"Multi-tenancy","id":"dxt-menu__pick-list__id--best-practices-connections-multi-tenancy","href":"/documentation/best-practices/managing-connections/multi-tenancy"}]},{"isCollapsible":true,"isOpen":false,"heading":"Branding and Naming","id":"branding-and-naming","items":[{"label":"Branding and Naming","id":"dxt-menu__pick-list__id--best-practices-branding-naming-overview","href":"/documentation/best-practices/branding-and-naming/branding"}]},{"isCollapsible":true,"isOpen":false,"heading":"Categorising Transactions","id":"categorising-transactions","items":[{"label":"Account and Payment Mapping","id":"dxt-menu__pick-list__id--best-practices-categorising-transactions-account-mapping","href":"/documentation/best-practices/categorising-transactions/account-mapping"},{"label":"Items Mapping","id":"dxt-menu__pick-list__id--best-practices-categorising-transactions-items-mapping","href":"/documentation/best-practices/categorising-transactions/items-mapping"},{"label":"Tracking Category Mapping","id":"dxt-menu__pick-list__id--best-practices-categorising-transactions-tracking-category-mapping","href":"/documentation/best-practices/categorising-transactions/tracking-category-mapping"}]},{"isCollapsible":true,"isOpen":false,"heading":"Data Integrity","id":"data-integrity","items":[{"label":"Contact mapping","id":"dxt-menu__pick-list__id--best-practices-data-integrity-contacts","href":"/documentation/best-practices/data-integrity/contacts"},{"label":"Creating Invoices","id":"dxt-menu__pick-list__id--best-practices-data-integrity-creating-invoices","href":"/documentation/best-practices/data-integrity/creating-invoices"},{"label":"Idempotent Requests","id":"dxt-menu__pick-list__id--best-practices-data-integrity-idempotency","href":"/documentation/best-practices/data-integrity/idempotency"},{"label":"Managing Tokens and Ids","id":"dxt-menu__pick-list__id--best-practices-data-integrity-managing-tokens","href":"/documentation/best-practices/data-integrity/managing-tokens"},{"label":"Multicurrency","id":"dxt-menu__pick-list__id--best-practices-data-integrity-multicurrency","href":"/documentation/best-practices/data-integrity/multicurrency"},{"label":"Rounding","id":"dxt-menu__pick-list__id--best-practices-data-integrity-rounding","href":"/documentation/best-practices/data-integrity/rounding"},{"label":"Taxes","id":"dxt-menu__pick-list__id--best-practices-data-integrity-taxes","href":"/documentation/best-practices/data-integrity/taxes"},{"label":"Webhooks","id":"dxt-menu__pick-list__id--best-practices-data-integrity-webhooks","href":"/documentation/best-practices/data-integrity/overview"}]},{"isCollapsible":true,"isOpen":false,"heading":"User Experience","id":"user-experience","items":[{"label":"Deep Linking","id":"dxt-menu__pick-list__id--best-practices-user-experience-deep-linking","href":"/documentation/best-practices/user-experience/deep-linking"},{"label":"Error Handling","id":"dxt-menu__pick-list__id--best-practices-user-experience-error-handling","href":"/documentation/best-practices/user-experience/error-handling"},{"label":"Invoice Status","id":"dxt-menu__pick-list__id--best-practices-user-experience-invoice-status","href":"/documentation/best-practices/user-experience/invoice-status"},{"label":"Invoice and Bank Transaction URLs","id":"dxt-menu__pick-list__id--best-practices-user-experience-transaction-urls","href":"/documentation/best-practices/user-experience/transaction-urls"}]},{"isCollapsible":true,"isOpen":false,"heading":"API Call Efficiencies","id":"api-call-efficiencies","items":[{"label":"Caching Data","id":"dxt-menu__pick-list__id--best-practices-api-call-efficiencies-caching-data","href":"/documentation/best-practices/api-call-efficiencies/caching-data"},{"label":"Filtering","id":"dxt-menu__pick-list__id--best-practices-api-call-efficiencies-filtering","href":"/documentation/best-practices/api-call-efficiencies/filtering"},{"label":"If-modified-since","id":"dxt-menu__pick-list__id--best-practices-api-call-efficiencies-if-modified-since","href":"/documentation/best-practices/api-call-efficiencies/if-modified-since"},{"label":"Paging","id":"dxt-menu__pick-list__id--best-practices-api-call-efficiencies-paging","href":"/documentation/best-practices/api-call-efficiencies/paging"},{"label":"Rate Limits","id":"dxt-menu__pick-list__id--best-practices-api-call-efficiencies-rate-limits","href":"/documentation/best-practices/api-call-efficiencies/rate-limits"},{"label":"Reducing Polling","id":"dxt-menu__pick-list__id--best-practices-api-call-efficiencies-reducing-polling","href":"/documentation/best-practices/api-call-efficiencies/reducing-polling"}]}]},{"isCollapsible":false,"heading":"Guides","id":"guides","items":[{"isCollapsible":true,"isOpen":false,"heading":"OAuth2","id":"oauth2","items":[{"label":"Overview","id":"dxt-menu__pick-list__id--guides-oauth2-overview","href":"/documentation/guides/oauth2/overview"},{"label":"The code flow","id":"dxt-menu__pick-list__id--guides-oauth2-auth-flow","href":"/documentation/guides/oauth2/auth-flow"},{"label":"The PKCE flow","id":"dxt-menu__pick-list__id--guides-oauth2-pkce-flow","href":"/documentation/guides/oauth2/pkce-flow"},{"label":"Custom Connections","id":"dxt-menu__pick-list__id--guides-oauth2-custom-connections","href":"/documentation/guides/oauth2/custom-connections"},{"label":"Client Credentials","id":"dxt-menu__pick-list__id--guides-oauth2-client-credentials","href":"/documentation/guides/oauth2/client-credentials"},{"label":"Token types","id":"dxt-menu__pick-list__id--guides-oauth2-token-types","href":"/documentation/guides/oauth2/token-types"},{"label":"Scopes","id":"dxt-menu__pick-list__id--guides-oauth2-scopes","href":"/documentation/guides/oauth2/scopes"},{"label":"Tenants","id":"dxt-menu__pick-list__id--guides-oauth2-tenants","href":"/documentation/guides/oauth2/tenants"},{"label":"Limits","id":"dxt-menu__pick-list__id--guides-oauth2-limits","href":"/documentation/guides/oauth2/limits"},{"label":"Troubleshooting","id":"dxt-menu__pick-list__id--guides-oauth2-troubleshooting","href":"/documentation/guides/oauth2/troubleshooting"}]},{"isCollapsible":true,"isOpen":false,"heading":"Webhooks","id":"webhooks","items":[{"label":"Overview","id":"dxt-menu__pick-list__id--guides-webhooks-overview","href":"/documentation/guides/webhooks/overview"},{"label":"Contacts","id":"dxt-menu__pick-list__id--guides-webhooks-contacts","href":"/documentation/guides/webhooks/contacts"},{"label":"Credit Notes","id":"dxt-menu__pick-list__id--guides-webhooks-credit-notes","href":"/documentation/guides/webhooks/credit-notes"},{"label":"Invoices","id":"dxt-menu__pick-list__id--guides-webhooks-invoices","href":"/documentation/guides/webhooks/invoices"},{"label":"Overpayments","id":"dxt-menu__pick-list__id--guides-webhooks-overpayments","href":"/documentation/guides/webhooks/overpayments"},{"label":"Payments","id":"dxt-menu__pick-list__id--guides-webhooks-payments","href":"/documentation/guides/webhooks/payments"},{"label":"Prepayments","id":"dxt-menu__pick-list__id--guides-webhooks-prepayments","href":"/documentation/guides/webhooks/prepayments"},{"label":"Subscriptions","id":"dxt-menu__pick-list__id--guides-webhooks-subscriptions","href":"/documentation/guides/webhooks/subscriptions"}]},{"isCollapsible":true,"isOpen":false,"heading":"Remote MCP","id":"remote-mcp","items":[{"label":"Overview","id":"dxt-menu__pick-list__id--guides-remotemcp-overview","href":"/documentation/guides/remote-mcp/overview"}]},{"isCollapsible":true,"isOpen":false,"heading":"Collaborators","id":"collaborators","items":[{"label":"Overview","id":"dxt-menu__pick-list__id--guides-collaborators-overview","href":"/documentation/guides/collaborators/overview"}]},{"isCollapsible":true,"isOpen":false,"heading":"Idempotent Requests","id":"idempotent-requests","items":[{"label":"Overview","id":"dxt-menu__pick-list__id--guides-api-guides-idempotency","href":"/documentation/guides/idempotent-requests/idempotency"}]},{"isCollapsible":true,"isOpen":false,"heading":"How-to guides","id":"how-to-guides","items":[{"label":"Integration best practices","id":"dxt-menu__pick-list__id--guides-api-guides-integration-best-practices","href":"/documentation/guides/how-to-guides/integration-best-practices"},{"label":"Xero App Launcher","id":"dxt-menu__pick-list__id--guides-how-to-guides-xero-app-launcher","href":"/documentation/guides/how-to-guides/xero-app-launcher"},{"label":"Branding your integration","id":"dxt-menu__pick-list__id--guides-api-guides-branding-your-integration","href":"/documentation/guides/how-to-guides/branding-your-integration"},{"label":"Deep link to Xero","id":"dxt-menu__pick-list__id--guides-api-guides-deep-link-xero","href":"/documentation/guides/how-to-guides/deep-link-xero"},{"label":"Tax in Xero","id":"dxt-menu__pick-list__id--guides-api-guides-tax-in-xero","href":"/documentation/guides/how-to-guides/tax-in-xero"},{"label":"Rounding in Xero","id":"dxt-menu__pick-list__id--guides-api-guides-rounding-in-xero","href":"/documentation/guides/how-to-guides/rounding-in-xero"},{"label":"Accounting for inventory","id":"dxt-menu__pick-list__id--guides-api-guides-how-to-integrate-my-inventory-system-with-xero","href":"/documentation/guides/how-to-guides/how-to-integrate-my-inventory-system-with-xero"},{"label":"Xero tracked inventory","id":"dxt-menu__pick-list__id--guides-api-guides-tracked-inventory-in-xero","href":"/documentation/guides/how-to-guides/tracked-inventory-in-xero"},{"label":"Processing payments","id":"dxt-menu__pick-list__id--guides-api-guides-handling-payment-processor-receipts-in-xero","href":"/documentation/guides/how-to-guides/handling-payment-processor-receipts-in-xero"},{"label":"Conversions guide","id":"dxt-menu__pick-list__id--guides-api-guides-conversions","href":"/documentation/guides/how-to-guides/conversions"},{"label":"CRM and Xero","id":"dxt-menu__pick-list__id--guides-api-guides-how-to-integrate-my-crm-system-with-xero","href":"/documentation/guides/how-to-guides/how-to-integrate-my-crm-system-with-xero"},{"label":"Farming and Xero","id":"dxt-menu__pick-list__id--guides-api-guides-farming-xero","href":"/documentation/guides/how-to-guides/farming-xero"},{"label":"Inventory and Xero","id":"dxt-menu__pick-list__id--guides-api-guides-inventory-integration-options","href":"/documentation/guides/how-to-guides/inventory-integration-options"},{"label":"Payment services and Xero","id":"dxt-menu__pick-list__id--guides-api-guides-payment-services-integration-with-xero","href":"/documentation/guides/how-to-guides/payment-services-integration-with-xero"},{"label":"Payroll and Xero","id":"dxt-menu__pick-list__id--guides-api-guides-how-to-integrate-my-payroll-system-with-xero","href":"/documentation/guides/how-to-guides/how-to-integrate-my-payroll-system-with-xero"},{"label":"Point of sale and Xero","id":"dxt-menu__pick-list__id--guides-api-guides-how-to-integrate-my-pos-system-with-xero","href":"/documentation/guides/how-to-guides/how-to-integrate-my-pos-system-with-xero"},{"label":"General lending write-back","id":"dxt-menu__pick-list__id--guides-api-guides-general-lending-integration-guide","href":"/documentation/guides/how-to-guides/general-lending-integration-guide"}]}]},{"isCollapsible":false,"heading":"Xero App Store","id":"xero-app-store","items":[{"isCollapsible":true,"isOpen":false,"heading":"App partner guides","id":"app-partner-guides","items":[{"label":"Grow your app with Xero","id":"dxt-menu__pick-list__id--app-partner-partner-guides-grow-your-app-with-xero","href":"/documentation/xero-app-store/app-partner-guides/grow-your-app-with-xero"},{"label":"Pathways to grow","id":"dxt-menu__pick-list__id--app-partner-partner-guides-pathways-to-grow","href":"/documentation/xero-app-store/app-partner-guides/pathways-to-grow"},{"label":"Building and growing your app","id":"dxt-menu__pick-list__id--app-partner-partner-guides-building-and-growing-your-app","href":"/documentation/xero-app-store/app-partner-guides/building-and-growing-your-app"},{"label":"App partner features","id":"dxt-menu__pick-list__id--app-partner-partner-guides-app-partner-features","href":"/documentation/xero-app-store/app-partner-guides/app-partner-features"},{"label":"Xero App Store listing","id":"dxt-menu__pick-list__id--app-partner-partner-guides-app-listing","href":"/documentation/xero-app-store/app-partner-guides/app-listing"},{"label":"Xero App Store referrals and billing","id":"dxt-menu__pick-list__id--app-partner-partner-guides-xero-app-store-referrals-and-billing","href":"/documentation/xero-app-store/app-partner-guides/xero-app-store-referrals-and-billing"},{"label":"Xero App Store subscriptions - Business Guide","id":"dxt-menu__pick-list__id--app-partner-partner-guides-xero-app-store-subscriptions","href":"/documentation/xero-app-store/app-partner-guides/xero-app-store-subscriptions"},{"label":"Xero App Store subscriptions - Technical Guide","id":"dxt-menu__pick-list__id--app-partner-partner-guides-xero-app-store-subscriptions-technical-guide","href":"/documentation/xero-app-store/app-partner-guides/xero-app-store-subscriptions-technical-guide"},{"label":"Xero App Store subscriptions pricing","id":"dxt-menu__pick-list__id--app-partner-partner-guides-xero-app-store-subscriptions-pricing","href":"/documentation/xero-app-store/app-partner-guides/xero-app-store-subscriptions-pricing"},{"label":"Usage Dashboard Guide","id":"dxt-menu__pick-list__id--app-partner-partner-guides-usage-dashboard-guide","href":"/documentation/xero-app-store/app-partner-guides/usage-dashboard-guide"},{"label":"FAQs","id":"dxt-menu__pick-list__id--app-partner-partner-guides-faqs","href":"/documentation/xero-app-store/app-partner-guides/faqs"},{"label":"Certification checkpoints","id":"dxt-menu__pick-list__id--app-partner-partner-guides-certification-checkpoints","href":"/documentation/xero-app-store/app-partner-guides/certification-checkpoints"},{"label":"Sign In with Xero","id":"dxt-menu__pick-list__id--app-partner-partner-guides-sign-in","href":"/documentation/xero-app-store/app-partner-guides/sign-in"},{"label":"Sign Up with Xero","id":"dxt-menu__pick-list__id--app-partner-partner-guides-sign-up","href":"/documentation/xero-app-store/app-partner-guides/sign-up"}]},{"isCollapsible":true,"isOpen":false,"heading":"App success tips","id":"app-success-tips","items":[{"label":"Xero App Store success","id":"dxt-menu__pick-list__id--app-success-tips-xero-app-store-success","href":"/documentation/xero-app-store/app-success-tips/xero-app-store-success"},{"label":"Building a great app","id":"dxt-menu__pick-list__id--app-success-tips-building-a-great-app","href":"/documentation/xero-app-store/app-success-tips/building-a-great-app"},{"label":"Positioning your app","id":"dxt-menu__pick-list__id--app-success-tips-positioning-your-app","href":"/documentation/xero-app-store/app-success-tips/positioning-your-app"},{"label":"Optimise your listing","id":"dxt-menu__pick-list__id--app-success-tips-optimise-your-listing","href":"/documentation/xero-app-store/app-success-tips/optimise-your-listing"},{"label":"Managing app reviews","id":"dxt-menu__pick-list__id--app-success-tips-managing-app-reviews","href":"/documentation/xero-app-store/app-success-tips/managing-app-reviews"},{"label":"Rebranding your app","id":"dxt-menu__pick-list__id--app-success-tips-rebranding-your-app","href":"/documentation/xero-app-store/app-success-tips/rebranding-your-app"}]},{"isCollapsible":true,"isOpen":false,"heading":"Market your app","id":"market-your-app","items":[{"label":"Marketing your app","id":"dxt-menu__pick-list__id--market-your-app-marketing-your-app","href":"/documentation/xero-app-store/market-your-app/marketing-your-app"},{"label":"Promoting App Partner offers","id":"dxt-menu__pick-list__id--market-your-app-promoting-app-partner-offers","href":"/documentation/xero-app-store/market-your-app/promoting-app-partner-offers"},{"label":"Social media marketing","id":"dxt-menu__pick-list__id--market-your-app-social-media-marketing","href":"/documentation/xero-app-store/market-your-app/social-media-marketing"},{"label":"Ready-made ads","id":"dxt-menu__pick-list__id--market-your-app-ready-made-ads","href":"/documentation/xero-app-store/market-your-app/ready-made-ads"},{"label":"SEM guidelines","id":"dxt-menu__pick-list__id--market-your-app-sem-guidelines","href":"/documentation/xero-app-store/market-your-app/sem-guidelines"},{"label":"Exhibiting at Xerocon","id":"dxt-menu__pick-list__id--market-your-app-exhibiting-at-xerocon","href":"/documentation/xero-app-store/market-your-app/exhibiting-at-xerocon"},{"label":"App collections","id":"dxt-menu__pick-list__id--market-your-app-how-collections-work","href":"/documentation/xero-app-store/market-your-app/how-collections-work"}]}]}],"doc":{"node":{"headings":[{"depth":2,"value":"Overview"},{"depth":3,"value":"What is the Developer Remote MCP Server?"},{"depth":3,"value":"Which clients does it work with?"},{"depth":3,"value":"Who can use it?"},{"depth":3,"value":"Authorisation flows"},{"depth":3,"value":"Certification"},{"depth":3,"value":"Security assessment"},{"depth":2,"value":"How it works"},{"depth":3,"value":"Working with more than one organisation"},{"depth":2,"value":"Get started"},{"depth":3,"value":"Before you begin, you will need"},{"depth":3,"value":"Connect your agent"},{"depth":3,"value":"Scopes"},{"depth":2,"value":"Tools"},{"depth":3,"value":"Tools that change data"}],"fileAbsolutePath":"/devx/packages/site/.cache/gatsby-source-git/XeroDocs/documentation/guides/remotemcp/overview.md","frontmatter":{"description":"Overview","id":"guides/remotemcp/overview","sidebar_label":"Overview","title":"Xero Developer Remote MCP","slug":"overview"},"rawMarkdownBody":"\nConnect an AI agent or client to Xero data and actions through a hosted URL: `https://api.xero.com/mcp/v1`. Nothing to install, and you sign in with the same OAuth 2.0 flow you already use for the Xero API.\n\n## Overview\n\n### What is the Developer Remote MCP Server?\n\nThe Developer Remote MCP Server is a hosted Model Context Protocol (MCP) server run by Xero. An MCP client, such as Claude Desktop, Cursor or an agent you’ve built, connects to it over a URL. Once connected, the AI agent or client can call Xero tools to read and write accounting data in organisations that have authorised your app.\n\nIt is recommended to use Xero’s existing [OAuth 2.0 flow with PKCE](/documentation/guides/oauth2/pkce-flow). You don’t need separate credentials, and a PKCE app that works with the Xero API also works with the Remote MCP Server. [Token type](/documentation/guides/oauth2/token-types) specifics remain the same.\n\n### Which clients does it work with?\n\nAny client that supports the MCP standard. This includes Claude Desktop, Claude Code, Cursor, VS Code and others.\n\n### Who can use it?\n\nRemote MCP access is included for your Commercial App if you are on the Core plan or above, so there’s no extra charge for it. Data returned through the Remote MCP Server counts towards your plan’s data egress volume, the same as Xero API calls. Rate limits, connection counts and egress metering use the existing API limits.\n\nCommercial Apps on the Starter plan can try out the Remote MCP Server with a demo organisation.\n\nSee [Xero Developer Pricing and Policies](/pricing).\n\n### Authorisation flows\n\nUse PKCE. It’s the flow we recommend because it doesn’t need a client secret, so there’s no secret to leak into a prompt, a configuration file or an AI development tool.\n\nWeb app access tokens also work technically, we still don’t recommend them. A web app’s client ID and client secret are easy to paste into AI-enabled tools by accident, and we’d rather you didn’t have to manage that risk.\n\n### Certification\n\nCertification rules haven’t changed. Apps on the Plus, Advanced and Enterprise plans must be certified, whether or not they use the Remote MCP Server.\n\n### Security assessment\n\nSecurity assessment rules haven’t changed. Apps on the Advanced and Enterprise plans must still undergo initial and annual security assessments, whether or not they use the Remote MCP Server.\n\n## How it works\n\n1. Create an app in Xero. PKCE is the recommended auth type.\n2. Your agent connects to the Remote MCP Server URL.\n3. The agent starts the Xero OAuth 2.0 authorisation flow with PKCE.\n4. A user signs in to Xero, picks the organisations to share, and approves the scopes your app requests.\n5. The agent receives an access token and calls tools. Each call runs against one organisation.\n6. Tool calls return Xero data to the agent, or make changes in Xero on the user’s behalf.\n\n### Working with more than one organisation\n\nA user can authorise several organisations for the same app. Ask the agent to list your connected organisations, then tell it which organisation to act on. Each organisation still goes through the standard OAuth consent step, and nothing about this is specific to MCP.\n\nMulti-organisation access shifts some work to your agent. It needs to track which organisation it’s acting on and make that clear to the user before it writes anything.\n\n## Get started\n\n### Before you begin, you will need\n\n- A Xero Developer account\n- An app that uses PKCE and is on a plan that can access the Remote MCP Server. This is available for apps on the Core plan or above\n- A Xero organisation to test against. Use a demo organisation if you’re on the Starter plan\n\n### Connect your agent\n\n1. Create or open your app in the [Xero Developer portal](/app/manage). When you create a Commercial app, choose PKCE as the authorisation method. Set the redirect URL per the required configuration of your MCP client. This will vary per client, so check its documentation.\n2. Copy the Remote MCP Server URL: `https://api.xero.com/mcp/v1`\n3. Add the URL to your MCP client as a remote server. The exact setting depends on the client, so check its documentation.\n4. Start the agent and sign in when Xero prompts you.\n5. Ask the agent to call `get_connected_tenants`. If it returns your organisation, you’re connected.\n\n### Scopes\n\nThe agent can only call tools your app has approved [scopes](/documentation/guides/oauth2/scopes) for. See the required scopes for each tool in the Tools section.\n\n## Tools\n\nThese tools are available at GA. Tool names are shown exactly as the server exposes them.\n\n| Group | Tools | Scope |\n| --- | --- | --- |\n| **Invoices and related records** | `list_invoices`, `list_credit_notes`, `list_items`, `list_quotes` | `accounting.invoices.read` |\n| **Invoices and related records** | `create_invoice`, `update_invoice`, `authorise_invoice`, `void_invoice`, `create_credit_note`, `update_credit_note`, `create_item`, `update_item`, `create_quote`, `update_quote` | `accounting.invoices` |\n| **Invoices and related records** | `list_tracking_categories` | `accounting.settings.read` |\n| **Invoices and related records** | `create_tracking_category`, `update_tracking_category`, `create_tracking_options`, `update_tracking_options` | `accounting.settings` |\n| **Contacts** | `list_contacts` | `accounting.contacts.read` |\n| **Contacts** | `create_contact`, `update_contact` | `accounting.contacts` |\n| **Bank transactions** | `list_bank_transactions` | `accounting.banktransactions.read` |\n| **Bank transactions** | `create_bank_transaction`, `update_bank_transaction` | `accounting.banktransactions` |\n| **Payments** | `list_payments` | `accounting.payments.read` |\n| **Payments** | `create_payment` | `accounting.payments` |\n| **Manual journals** | `list_manual_journals` | `accounting.manualjournals.read` |\n| **Manual journals** | `create_manual_journal`, `update_manual_journal` | `accounting.manualjournals` |\n| **Reports** | `list_profit_and_loss` | `accounting.reports.profitandloss.read` |\n| **Reports** | `list_report_balance_sheet` | `accounting.reports.balancesheet.read` |\n| **Reports** | `list_trial_balance` | `accounting.reports.trialbalance.read` |\n| **Reports** | `list_aged_payables_by_contact`, `list_aged_receivables_by_contact` | `accounting.reports.aged.read` |\n| **Settings** | `list_accounts`, `list_tax_rates`, `list_organisation_details` | `accounting.settings.read` |\n| **Other** | `get_connected_tenants` | None required |\n\n### Tools that change data\n\nTools that start with `create_`, `update_`, `authorise_` or `void_` write to the organisation. `void_invoice` and `authorise_invoice` change the state of a financial record. Build a confirmation step into your agent before it calls them.\n\nWhen using the `authorise_invoice` and `void_invoice` tools via this MCP server, be aware that standard Xero business logic and [invoice status transition](/documentation/api/accounting/invoices) rules still strictly apply.\n"}}}},"staticQueryHashes":["2540617144","4153388373","92823798"]}