xeroapi_xero_mcp_server
by XeroAPIXero MCP Server for Accounting Integration
Overview
The Xero MCP Server is a specialized implementation of the Model Context Protocol (MCP) designed to integrate seamlessly with Xero's accounting and business APIs. It acts as a bridge between the MCP protocol and Xero, enabling standardized access to Xero's financial data and features.
Features
- Xero OAuth2 Authentication: Supports custom connections for secure access.
- Contact Management: Retrieve and manage contacts within Xero.
- Chart of Accounts Management: Access and manage financial accounts.
- Invoice Management: Create, update, and manage invoices.
- MCP Protocol Compliance: Fully compliant with the MCP protocol for seamless integration.
Prerequisites
To use the Xero MCP Server, ensure you have the following:
- Node.js (v18 or higher)
- npm or pnpm
- A Xero Developer Account with API credentials
Configuring Your Xero Developer Account
Set up a Custom Connection by following the Xero OAuth2 Custom Connections Guide. The following scopes are required:
- accounting.transactions
- accounting.contacts
- accounting.settings.read
Usage
Integrating with Claude Desktop
To integrate the Xero MCP Server with Claude Desktop, follow these steps:
1. Go to Settings > Developer > Edit Config.
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"
}
}
}
}
Available MCP Commands
The Xero MCP Server supports the following commands:
- list-contacts: Retrieve a list of contacts.
- list-invoices: Retrieve a list of invoices.
- list-accounts: Retrieve a list of accounts.
- list-tax-rates: Retrieve a list of tax rates.
- list-quotes: Retrieve a list of quotes.
- list-credit-notes: Retrieve a list of credit notes.
- create-contact: Create a new contact.
- create-invoice: Create a new invoice.
- create-quote: Create a new quote.
- create-credit-note: Create a new credit note.
- update-contact: Update an existing contact.
- update-invoice: Update an existing draft invoice.
For detailed API documentation, refer to the MCP Protocol Specification.
Configuration
Installation
To install the Xero MCP Server, run the following commands:
# Using npm
npm install
# Using pnpm
pnpm install
Building the Server
To build the server, use the following commands:
# Using npm
npm run build
# Using pnpm
pnpm build
Security
- Do not commit sensitive credentials: Avoid committing your
.envfile or any sensitive data to version control.
License
The Xero MCP Server is licensed under the MIT License.
Resources
Contributors
Languages
- TypeScript (94.7%)
- JavaScript (5.2%)
- Shell (0.1%)
Invite Gmail Contacts
