이것은 Xero용 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. MCP 프로토콜과 Xero의 API 사이의 다리 역할을 하여 Xero의 회계 및 비즈니스 기능에 표준화된 접근을 가능하게 합니다.

특징

• 맞춤형 연결을 통한 Xero OAuth2 인증
• 접촉 관리
• 회계 계정증 관리
• 송장 생성 및 관리
• MCP 프로토콜 준수

선수 조건

• Node.js (v18 이상)
• NPM 또는 PNPM
• API 자격 증명이 있는 Xero 개발자 계정

문서와 링크

• Xero 공개 API 문서
• Xero API 익스플로러
• Xero OpenAPI 사양
• Xero-Node 공개 API SDK 문서
• 개발자 문서

준비

Xero 계정 생성

아직 Xero 계정과 조직이 없다면, 여기에서 무료 체험을 통해 가입하여 생성할 수 있습니다.

데모 회사를 사용하는 것을 추천합니다. 이 회사는 미리 설치된 샘플 데이터가 포함되어 있기 때문입니다. 로그인 후에는 왼쪽 상단 드롭다운에서 "데모 회사"를 선택하여 데모 회사로 전환하세요. 언제든지 데모 회사의 데이터를 재설정하거나 국가를 변경할 수 있으며, 왼쪽 상단 드롭다운을 이용해 My Xero로 이동하면 가능합니다.

Xero MCP Server

This is a Model Context Protocol (MCP) server implementation for Xero. It provides a bridge between the MCP protocol and Xero’s API, allowing for standardized access to Xero’s accounting and business features.

Features

• Xero OAuth2 authentication with custom connections
• Contact management
• Chart of Accounts management
• Invoice creation and management
• MCP protocol compliance

Prerequisites

• Node.js (v18 or higher)
• npm or pnpm
• A Xero developer account with API credentials

Docs and Links

• Xero Public API Documentation
• Xero API Explorer
• Xero OpenAPI Specs
• Xero-Node Public API SDK Docs
• Developer Documentation

Setup

Create a Xero Account

If you don’t already have a Xero account and organisation already, can create one by signing up here using the free trial.

We recommend using a Demo Company to start with because it comes with some pre-loaded sample data. Once you are logged in, switch to it by using the top left-hand dropdown and selecting “Demo Company”. You can reset the data on a Demo Company, or change the country, at any time by using the top left-hand dropdown and navigating to My Xero.

NOTE: To use Payroll-specific queries, the region should be either NZ or UK.

Authentication

There are 2 modes of authentication supported in the Xero MCP server:

1. Custom Connections

This is a better choice for testing and development which allows you to specify client id and secrets for a specific organisation. It is also the recommended approach if you are integrating this into 3rd party MCP clients such as Claude Desktop.

Configuring your Xero Developer account

Set up a Custom Connection following these instructions: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

Required Scopes

Custom connections require different scopes depending on when they were created. All scopes in the relevant list must be added to your custom connection:

Note: The MCP server automatically tries V1 scopes first and falls back to V2 if needed.

You can override these by setting the XERO_SCOPES environment variable to a space-separated list of scopes.

Integrating the MCP server with Claude Desktop

To add the MCP server to Claude go to Settings > Developer > Edit config and add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
    "xero": {
      "command": "npx",