Xero MCP Server Setup Guide

Prerequisites
  1. Node.js: Ensure you have Node.js (v18 or higher) installed.
  2. Package Manager: Have either npm or pnpm installed.
  3. Xero Developer Account: Obtain API credentials by setting up a Xero developer account.

Configuring Your Xero Developer Account

  1. Set up a Custom Connection by following the instructions at: Xero Custom Connections Guide.
  2. Ensure the following scopes are included:
    • accounting.transactions
    • accounting.contacts
    • accounting.settings.read

Installation

Using npm

npm install
 

Using pnpm

pnpm install
 

Run a Build

Using npm

npm run build
 

Using pnpm

pnpm build
 

Integrating with Claude Desktop

  1. Navigate to Settings > Developer > Edit config in Claude Desktop.
  2. Add the following configuration to your claude_desktop_config.json file:
{
  "mcpServers": {
  "xero": {
  "command": "npx",
  "args": ["-y", "@xeroapi/xero-mcp-server@latest"],
  "env": {
  "XERO_CLIENT_ID": "your_client_id_here",
  "XERO_CLIENT_SECRET": "your_client_secret_here"
  }
  }
  }
 }
 

Security

  • Ensure that you do not commit your .env file or any sensitive credentials to version control.

License

  • This project is licensed under the MIT License.
Share this post: