# Xero (MCP Server)

> Work with Xero invoices, contacts, payments, payroll and reports

- Type: MCP server
- Publisher: Xero (official)
- Categories: Finance, Business
- Website: https://github.com/XeroAPI/xero-mcp-server
- Source: https://github.com/XeroAPI/xero-mcp-server
- Transport: stdio
- Launch command: npx -y @xeroapi/xero-mcp-server@latest
- Sign-in: api-key
- Environment variables: XERO_CLIENT_ID, XERO_CLIENT_SECRET
- GitHub stars: 376
- Listed: 2025-03-17

## About

Xero's official MCP server lets AI assistants list and create invoices, contacts, quotes, payments, bank transactions and manual journals, run reports like profit and loss or balance sheet, and handle payroll timesheets and leave. It runs locally via npx and authenticates with a Xero custom connection (client ID and secret) or a bearer token.

## Install

1. **Add the server to Codex**

   Codex CLI:

   ```bash
   codex mcp add xero --env XERO_CLIENT_ID=YOUR_XERO_CLIENT_ID --env XERO_CLIENT_SECRET=YOUR_XERO_CLIENT_SECRET -- npx -y @xeroapi/xero-mcp-server@latest
   ```

   config.toml:

   ```toml
   [mcp_servers.xero]
   command = "npx"
   args = ["-y", "@xeroapi/xero-mcp-server@latest"]
   
   [mcp_servers.xero.env]
   XERO_CLIENT_ID = "YOUR_XERO_CLIENT_ID"
   XERO_CLIENT_SECRET = "YOUR_XERO_CLIENT_SECRET"
   ```

   Agents SDK:

   ```python
   from agents import Agent, Runner
   from agents.mcp import MCPServerStdio
   
   async with MCPServerStdio(
       name="Xero",
       params={"command": "npx", "args": ["-y", "@xeroapi/xero-mcp-server@latest"]},
   ) as server:
       agent = Agent(name="Assistant", mcp_servers=[server])
       result = await Runner.run(agent, "Show the profit and loss report for last month")
       print(result.final_output)
   ```

## Tools

- `list-accounts`
- `list-contacts`
- `list-invoices`
- `list-profit-and-loss`
- `list-report-balance-sheet`
- `list-bank-transactions`
- `list-payroll-employees`
- `create-invoice`
- `create-contact`
- `create-payment`
- `update-invoice`

## Example prompts

- "Show the profit and loss report for last month"
- "Which customers have overdue invoices?"
- "Create a draft invoice for Contoso for $2,400"
- "List bank transactions over $1,000 this week"

## Also available as

- app: [Xero](https://chatgptplugins.directory/apps/xero.md)

## Related

- [Stripe](https://chatgptplugins.directory/mcp/stripe.md): Query and act on your Stripe account and search Stripe docs from any agent
- [monday.com](https://chatgptplugins.directory/mcp/monday-com.md): Create items, update columns, and manage boards in monday.com
- [QuickBooks Online](https://chatgptplugins.directory/mcp/quickbooks-online.md): Read and write QuickBooks customers, invoices, bills and reports
- [PayPal](https://chatgptplugins.directory/mcp/paypal.md): Manage PayPal invoices, orders, subscriptions, disputes and transactions
- [Massive (Polygon.io)](https://chatgptplugins.directory/mcp/massive.md): Stock, options, forex and crypto market data from Massive, formerly Polygon.io
- [Alpha Vantage](https://chatgptplugins.directory/mcp/alpha-vantage.md): Real-time and historical stock, forex, crypto and economic data

---
Source: https://chatgptplugins.directory/mcp/xero · Index: https://chatgptplugins.directory/llms.txt · Independent and community-run. Not affiliated with or endorsed by OpenAI. ChatGPT is a trademark of OpenAI.