# Xero

> Xero is an open-source MCP server for finance and payments. Xero MCP server for invoices, contacts, payments, quotes, and financial reports. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/mindstone/mcp-servers/tree/HEAD/connectors/xero
- **MCP Registry name:** io.github.mindstone/mcp-server-xero
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-13

## About

Xero MCP server for invoices, contacts, payments, quotes, and financial reports.

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server-xero --env XERO_CLIENT_ID='<XERO_CLIENT_ID>' --env XERO_CLIENT_SECRET='<XERO_CLIENT_SECRET>' --env XERO_REFRESH_TOKEN='<XERO_REFRESH_TOKEN>' --env XERO_CLIENT_BEARER_TOKEN='<XERO_CLIENT_BEARER_TOKEN>' -- npx -y @mindstone/mcp-server-xero
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server-xero": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-xero"
      ],
      "env": {
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_REFRESH_TOKEN": "<XERO_REFRESH_TOKEN>",
        "XERO_CLIENT_BEARER_TOKEN": "<XERO_CLIENT_BEARER_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server-xero": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-xero"
      ],
      "env": {
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_REFRESH_TOKEN": "<XERO_REFRESH_TOKEN>",
        "XERO_CLIENT_BEARER_TOKEN": "<XERO_CLIENT_BEARER_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server-xero": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-xero"
      ],
      "env": {
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_REFRESH_TOKEN": "<XERO_REFRESH_TOKEN>",
        "XERO_CLIENT_BEARER_TOKEN": "<XERO_CLIENT_BEARER_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server-xero": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-xero"
      ],
      "env": {
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_REFRESH_TOKEN": "<XERO_REFRESH_TOKEN>",
        "XERO_CLIENT_BEARER_TOKEN": "<XERO_CLIENT_BEARER_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server-xero": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-xero"
      ],
      "env": {
        "XERO_CLIENT_ID": "<XERO_CLIENT_ID>",
        "XERO_CLIENT_SECRET": "<XERO_CLIENT_SECRET>",
        "XERO_REFRESH_TOKEN": "<XERO_REFRESH_TOKEN>",
        "XERO_CLIENT_BEARER_TOKEN": "<XERO_CLIENT_BEARER_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Is Xero free?

Yes. Xero is open source, so you can use and self-host it for free.

### How do I add Xero to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-xero --env XERO_CLIENT_ID='<XERO_CLIENT_ID>' --env XERO_CLIENT_SECRET='<XERO_CLIENT_SECRET>' --env XERO_REFRESH_TOKEN='<XERO_REFRESH_TOKEN>' --env XERO_CLIENT_BEARER_TOKEN='<XERO_CLIENT_BEARER_TOKEN>' -- npx -y @mindstone/mcp-server-xero

## Where this comes from

- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Xero MCP](https://ai-powered.com/mcp/xero-mcp): Xero MCP is an open-source MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/xero
