# How to connect Xero to Claude Cowork

```json
{
  "title": "How to connect Xero to Claude Cowork",
  "toolkit": "Xero",
  "toolkit_slug": "xero",
  "framework": "Claude Cowork",
  "framework_slug": "claude-cowork",
  "url": "https://composio.dev/toolkits/xero/framework/claude-cowork",
  "markdown_url": "https://composio.dev/toolkits/xero/framework/claude-cowork.md",
  "updated_at": "2026-05-12T10:30:48.664Z"
}
```

## Introduction

Cowork is Anthropic's AI agent for knowledge work. Think of it as Claude Code for everything else. It works autonomously with your computer, local files, and applications to accomplish complex tasks.
This guide walks you through the easiest and most secure way to connect your Xero account to Cowork via Composio Connect, enabling it to list all active Xero tenant connections, show latest contacts added this week, retrieve all open quotes for this month, and more such actions on your behalf without compromising your account security.

## Also integrate Xero with

- [ChatGPT](https://composio.dev/toolkits/xero/framework/chatgpt)
- [Antigravity](https://composio.dev/toolkits/xero/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/xero/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/xero/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/xero/framework/claude-code)
- [Codex](https://composio.dev/toolkits/xero/framework/codex)
- [Cursor](https://composio.dev/toolkits/xero/framework/cursor)
- [VS Code](https://composio.dev/toolkits/xero/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/xero/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/xero/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/xero/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/xero/framework/cli)
- [Google ADK](https://composio.dev/toolkits/xero/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/xero/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/xero/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/xero/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/xero/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/xero/framework/crew-ai)

## Connect Xero to Claude Cowork

### Connecting Xero to Claude Cowork
1. Open Customize
In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.
2. Add the Composio MCP server
Click Add custom connector and paste in the Composio MCP server URL:

```bash
https://connect.composio.dev/mcp
```

## What is Claude Cowork?

Claude Cowork is Anthropic's agent for general knowledge work. It can use your computer, files, and connected applications to complete longer-running tasks across your work tools.
With Composio Connect, Cowork can securely access apps like Xero through MCP without you sharing account credentials directly with the agent.

## What is the Xero MCP server, and what's possible with it?

The Xero MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Xero account. It provides structured and secure access to your accounting data, so your agent can retrieve contacts, manage connections, update invoices, and monitor quotes automatically on your behalf.
- Connection management: Instantly list all active Xero tenant connections linked to your account, making it easy for your agent to select and operate on the right organization.
- Contact retrieval and lookup: Fetch detailed, up-to-date lists of business contacts including filtering, paging, and incremental updates to keep your records synchronized and actionable.
- Quote management and tracking: Retrieve, filter, or search through your sales quotes so your agent can help you stay on top of prospective business and follow up faster.
- Invoice updating and automation: Modify details of existing invoices—such as amounts, due dates, and line items—allowing your agent to keep your invoicing accurate and up to date without manual edits.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `XERO_CREATE_BANK_TRANSACTION` | Create Bank Transaction | Create a bank transaction in Xero. Use SPEND for payments out or RECEIVE for money received. |
| `XERO_CREATE_CONTACT` | Create Contact | Create a new contact in Xero. Contacts can be customers, suppliers, or both. |
| `XERO_CREATE_INVOICE` | Create Invoice | Create a new invoice in Xero. Supports both sales invoices (ACCREC) and bills (ACCPAY). |
| `XERO_CREATE_ITEM` | Create Item | Create an inventory item in Xero. Items can be tracked for sales and/or purchases. |
| `XERO_CREATE_MANUAL_JOURNAL` | Create Manual Journal | Create one or more manual journals (journal entries) in Xero with journal lines. Manual journals must balance (debits equal credits). |
| `XERO_CREATE_PAYMENT` | Create Payment | Create a payment in Xero to link an invoice with a bank account transaction. |
| `XERO_CREATE_PURCHASE_ORDER` | Create Purchase Order | Create a purchase order in Xero to order goods/services from suppliers. |
| `XERO_GET_ACCOUNT` | Get Account | Retrieve a specific account from Xero's chart of accounts by its unique ID. Returns detailed account information including code, name, type (BANK, REVENUE, EXPENSE, etc.), status (ACTIVE/ARCHIVED), tax settings, bank details (for BANK accounts), and classification. Use XERO_LIST_ACCOUNTS to get account IDs if you don't already have one. |
| `XERO_GET_ASSET` | Get Asset | Retrieve a specific asset by ID from Xero. Returns depreciation details and book value. |
| `XERO_GET_BALANCE_SHEET_REPORT` | Get Balance Sheet Report | Retrieve Balance Sheet report from Xero. Shows assets, liabilities, and equity at a specific date. Liability and credit balances appear as negative numbers in the response. Response structure is Reports → Rows → Sections; account lines are nested inside group sections and summary totals (e.g., 'Total Current Assets') appear in SummaryRows. |
| `XERO_GET_BUDGET` | Get Budget | Retrieve a budget from Xero. Budgets track planned vs actual spending by account. |
| `XERO_GET_CONNECTIONS` | Get Connections | Tool to list active Xero connections. Use to retrieve all current tenant connections for the authenticated user and resolve the correct tenant_id before making data requests. When multiple tenants are returned, never assume the first connection is correct — always explicitly pass the intended tenant_id to every subsequent call. Using a wrong or stale tenant_id can silently return or modify data for a different organisation. |
| `XERO_GET_CONTACTS` | Get Contacts | Tool to retrieve a list of contacts. Use when you need up-to-date contact information with filtering, paging, or incremental updates. |
| `XERO_GET_INVOICE` | Get Invoice | Retrieve a specific invoice by ID from Xero. Returns full invoice details including line items and status. |
| `XERO_GET_ITEM` | Get Item | Retrieve a specific item by ID from Xero. Returns item code, name, pricing, and tax details. |
| `XERO_GET_MANUAL_JOURNAL` | Get Manual Journal | Retrieve a specific manual journal by ID from Xero. Returns full details including journal lines. |
| `XERO_GET_ORGANISATION` | Get Organisation | Retrieve organisation details from Xero. Returns company info, base currency, timezone, financial year settings, SalesTaxBasis, SalesTaxPeriod, etc. Response fields are nested under data.data.Organisations[0]. Use Timezone when computing date ranges to avoid boundary errors. |
| `XERO_GET_PROFIT_LOSS_REPORT` | Get Profit & Loss Report | Retrieve Profit & Loss report from Xero. Shows income, expenses, and net profit for a specified period. Response rows are labeled (e.g., 'Net Profit', SummaryRow); parse by row label, not array index. Aggregates multiple tax codes — not suitable for tax compliance reporting. |
| `XERO_GET_PROJECT` | Get Project | Retrieve a specific project by ID from Xero. Returns project details, deadlines, and status. |
| `XERO_GET_PURCHASE_ORDER` | Get Purchase Order | Retrieve a specific purchase order by ID from Xero. Returns full details including line items and status. |
| `XERO_GET_QUOTES` | Get Quotes | Tool to retrieve a list of quotes. Use when you need to list, filter, or page through sales quotes. Use after obtaining the tenant ID via connections. |
| `XERO_GET_TRIAL_BALANCE_REPORT` | Get Trial Balance Report | Retrieve Trial Balance report from Xero. Shows all account balances (debits and credits) at a specific date. Use to verify that total debits equal total credits and to prepare financial statements. Credit balances appear as negative numbers in the response. |
| `XERO_LIST_ACCOUNTS` | List Accounts | Retrieve chart of accounts from Xero. Returns all accounting codes used for categorizing transactions. Use AccountID (not name or code) as the unique identifier for accounts. Results may be paginated; increment the page parameter until empty results are returned to avoid missing accounts in large organisations. |
| `XERO_LIST_ASSETS` | List Assets | Retrieve fixed assets from Xero. Assets track depreciation and book value of capital equipment. |
| `XERO_LIST_ATTACHMENTS` | List Attachments | List all attachments for a specific entity in Xero (invoice, contact, etc.). |
| `XERO_LIST_BANK_TRANSACTIONS` | List Bank Transactions | Retrieve bank transactions from Xero. Includes SPEND, RECEIVE, and transfer types; unfiltered results include DELETED transactions that skew totals. Dates returned in /Date(milliseconds_since_epoch)/ format. Rate limit: ~60 requests/minute per org; heavy pagination may trigger 429 errors. |
| `XERO_LIST_CREDIT_NOTES` | List Credit Notes | Retrieve list of credit notes from Xero. Credit notes are issued to reduce amounts owed by customers. |
| `XERO_LIST_FILES` | List Files | Retrieve files from Xero Files. Lists documents stored in Xero's file management system. |
| `XERO_LIST_FOLDERS` | List Folders | Retrieve folders from Xero Files. Lists document folders in Xero's file management system. |
| `XERO_LIST_INVOICES` | List Invoices | Retrieve a list of invoices from Xero. Results include both sales invoices (Type=ACCREC) and bills (Type=ACCPAY) by default; filter by Type in the `where` clause when only one is needed. Supports filtering by status, contact, date range, and pagination. |
| `XERO_LIST_ITEMS` | List Items | Retrieve items (inventory/products) from Xero. Items can be tracked for sales and/or purchases. |
| `XERO_LIST_JOURNALS` | List Journals | Retrieve journals from Xero. Journals show the accounting entries for all transactions. Omitting filters returns the full historical journal ledger and can produce very large responses — use If-Modified-Since and/or paymentsOnly to narrow scope. No date range filter parameter exists. Results are returned inside a Journals array field. |
| `XERO_LIST_MANUAL_JOURNALS` | List Manual Journals | Retrieve manual journals from Xero. Manual journals are used for period-end adjustments and corrections. |
| `XERO_LIST_PAYMENTS` | List Payments | Retrieve list of payments from Xero. Payments link invoices to bank transactions; invoices may have multiple partial/split payment records. Response Date fields use Xero's /Date(milliseconds)/ format requiring custom parsing. |
| `XERO_LIST_PROJECTS` | List Projects | Retrieve projects from Xero. Projects track time and costs for client work. |
| `XERO_LIST_PURCHASE_ORDERS` | List Purchase Orders | Retrieve list of purchase orders from Xero. Purchase orders track goods/services ordered from suppliers. |
| `XERO_LIST_TAX_RATES` | List Tax Rates | Retrieve tax rates from Xero. Shows available tax codes and rates for the organization. Use returned tax codes as valid `TaxType` values in other tools — invalid values cause ValidationException errors. |
| `XERO_LIST_TRACKING_CATEGORIES` | List Tracking Categories | Retrieve tracking categories from Xero. Tracking categories are used to segment data for reporting (e.g., departments, regions). |
| `XERO_POST_INVOICE_UPDATE` | Update Invoice | Tool to update an existing invoice. Use when you need to modify the details of an invoice after it's been created. |
| `XERO_UPDATE_CONTACT` | Update Contact | Update an existing contact in Xero. Only provided fields will be updated. |
| `XERO_UPLOAD_ATTACHMENT` | Upload Attachment | Upload a file attachment to a Xero entity (invoice, contact, etc.). Supports PDF, images, and documents. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Xero MCP server connects Claude Cowork to your Xero account through Composio. Once connected, Cowork can use the available Xero tools and triggers to complete tasks on your behalf.

## Complete Code

None listed.

## How to build Xero MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/xero/framework/chatgpt)
- [Antigravity](https://composio.dev/toolkits/xero/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/xero/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/xero/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/xero/framework/claude-code)
- [Codex](https://composio.dev/toolkits/xero/framework/codex)
- [Cursor](https://composio.dev/toolkits/xero/framework/cursor)
- [VS Code](https://composio.dev/toolkits/xero/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/xero/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/xero/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/xero/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/xero/framework/cli)
- [Google ADK](https://composio.dev/toolkits/xero/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/xero/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/xero/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/xero/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/xero/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/xero/framework/crew-ai)

## Related Toolkits

- [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide.
- [Alpha vantage](https://composio.dev/toolkits/alpha_vantage) - Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.
- [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management.
- [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly.
- [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth.
- [Chaser](https://composio.dev/toolkits/chaser) - Chaser is accounts receivable automation software that sends invoice reminders and helps businesses get paid faster. It streamlines the collections process to save time and improve cash flow.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Coinbase](https://composio.dev/toolkits/coinbase) - Coinbase is a platform for buying, selling, and storing cryptocurrency. It makes exchanging and managing crypto simple and secure for everyone.
- [Coinranking](https://composio.dev/toolkits/coinranking) - Coinranking is a comprehensive cryptocurrency market data platform offering access to real-time coin prices, market caps, and historical data. Get accurate, up-to-date stats for thousands of digital assets in one place.
- [Coupa](https://composio.dev/toolkits/coupa) - Coupa is a business spend management platform for procurement, invoicing, and expenses. It helps organizations streamline purchasing, control costs, and gain complete visibility over financial operations.
- [CurrencyScoop](https://composio.dev/toolkits/currencyscoop) - CurrencyScoop is a developer-friendly API for real-time and historical currency exchange rates. Easily access fiat and crypto data for smart, up-to-date financial applications.
- [Daffy](https://composio.dev/toolkits/daffy) - Daffy is a modern charitable giving platform with a donor-advised fund. Easily set aside funds, grow them tax-free, and donate to over 1.7 million U.S. charities.
- [Eagle doc](https://composio.dev/toolkits/eagle_doc) - Eagle doc is an AI-powered OCR API for invoices and receipts. It delivers fast, reliable, and accurate document data extraction for seamless automation.
- [Elorus](https://composio.dev/toolkits/elorus) - Elorus is an online invoicing and time-tracking software for freelancers and small businesses. Easily manage finances, bill clients, and track work in one place.
- [Eodhd apis](https://composio.dev/toolkits/eodhd_apis) - Eodhd apis delivers comprehensive financial data, including live and historical stock prices, via robust APIs. Easily access reliable, up-to-date market insights to power your apps, dashboards, and analytics.
- [Fidel api](https://composio.dev/toolkits/fidel_api) - Fidel api is a secure platform for linking payment cards to web and mobile apps. It enables real-time card transaction monitoring and event-based automation for businesses.
- [Finage](https://composio.dev/toolkits/finage) - Finage is a secure API platform delivering real-time and historical financial data for stocks, forex, crypto, indices, and commodities. It empowers developers and businesses to access, analyze, and act on market data instantly.
- [Finmei](https://composio.dev/toolkits/finmei) - Finmei is an invoicing tool that simplifies billing, invoice management, and expense tracking. Ideal for automating and organizing your business finances in one place.
- [Fixer](https://composio.dev/toolkits/fixer) - Fixer is a currency data API offering real-time and historical exchange rates for 170 currencies. Instantly access accurate, up-to-date forex data for your applications and workflows.
- [Fixer io](https://composio.dev/toolkits/fixer_io) - Fixer.io is a lightweight API for real-time and historical foreign exchange rates. It makes global currency conversion fast, accurate, and hassle-free.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Xero MCP?

With a standalone Xero MCP server, the agents and LLMs can only access a fixed set of Xero tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Xero and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Claude Cowork?

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Xero tools.

### Can I manage the permissions and scopes for Xero while using Tool Router?

Yes, absolutely. You can configure which Xero scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Xero data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)