hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides a bridge to Xero's accounting and business features, including contact management, chart of accounts management, and invoice creation and management, using OAuth2 authentication.

Xero MCP 服务器

这是 Xero 的模型上下文协议 (MCP) 服务器实现。它在 MCP 协议和 Xero 的 API 之间架起了一座桥梁，从而实现了对 Xero 会计和业务功能的标准化访问。

特征

使用自定义连接的 Xero OAuth2 身份验证
联系人管理
科目表管理
发票创建和管理
MCP 协议合规性

先决条件

Node.js（v18 或更高版本）
npm 或 pnpm
具有 API 凭证的 Xero 开发者帐户

文档和链接

设置

创建Xero帐户

如果您还没有 Xero 帐户和组织，可以在此处注册并使用免费试用版创建一个。

我们建议您首先使用演示公司，因为它预装了一些示例数据。登录后，使用左上角下拉菜单并选择“演示公司”切换到演示公司。您可以随时使用左上角下拉菜单并导航至“我的 Xero”重置演示公司的数据或更改国家/地区。

注意：要使用特定于工资单的查询，地区应该是新西兰或英国。

验证

Xero MCP 服务器支持两种身份验证模式：

1.自定义连接

对于测试和开发来说，这是一个更好的选择，因为它允许您为特定组织指定客户端 ID 和密钥。如果您要将其集成到第三方 MCP 客户端（例如 Claude Desktop），这也是推荐的方法。

配置您的 Xero Developer 帐户

按照以下说明设置自定义连接： https://developer.xero.com/documentation/guides/oauth2/custom-connections/

目前所有会话都需要以下范围：范围

将 MCP 服务器与 Claude Desktop 集成

要将 MCP 服务器添加到 Claude，请转到“设置”>“开发人员”>“编辑配置”，然后将以下内容添加到您的 claude_desktop_config.json 文件中：

{
  "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"
      }
    }
  }
}

注意：如果您使用Node 版本管理器"command": "npx"部分将其更改为可执行文件的完整路径，即：在 Mac / Linux 上为your_home_directory/.nvm/versions/node/v22.14.0/bin/npx在 Windows 上为"your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx"

2. Bearer Token

如果您需要在运行时支持多个 Xero 帐户，并允许 MCP 客户端根据需要执行身份验证流程（例如 PKCE），那么这是一个更好的选择。在这种情况下，请使用以下配置：

{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@xeroapi/xero-mcp-server@latest"],
      "env": {
        "XERO_CLIENT_BEARER_TOKEN": "your_bearer_token"
      }
    }
  }
}

注意：如果定义了XERO_CLIENT_BEARER_TOKEN ，则它将优先于XERO_CLIENT_ID 。

可用的 MCP 命令

list-accounts ：检索帐户列表
list-contacts ：从 Xero 检索联系人列表
list-credit-notes ：检索信用票据列表
list-invoices ：检索发票列表
list-items ：检索项目列表
list-organisation-details ：检索有关组织的详细信息
list-profit-and-loss ：检索损益报告
list-quotes ：检索引文列表
list-tax-rates ：检索税率列表
list-payments ：检索付款列表
list-trial-balance ：检索试算表报告
list-profit-and-loss ：检索损益报告
list-bank-transactions ：检索银行账户交易列表
list-payroll-employees ：检索工资员工列表
list-report-balance-sheet ：检索资产负债表报告
list-payroll-employee-leave ：检索工资员工的休假记录
list-payroll-employee-leave-balances ：检索工资员工的休假余额
list-payroll-employee-leave-types ：检索工资休假类型列表
list-payroll-leave-periods ：检索工资员工休假期间列表
list-payroll-leave-types ：检索 Xero Payroll 中所有可用休假类型的列表
list-aged-receivables-by-contact ：检索联系人的应收账款账龄
list-aged-payables-by-contact ：检索联系人的应付账款
list-contact-groups ：检索联系人组列表
create-contact ：创建新联系人
create-credit-note ：创建新的信用票据
create-invoice ：创建新发票
create-payment ：创建新付款
create-quote ：创建新的报价
create-credit-note ：创建新的信用票据
create-payroll-timesheet ：创建新的工资时间表
update-contact ：更新现有联系人
update-invoice ：更新现有的发票草稿
update-quote ：更新现有的草稿报价
update-credit-note ：更新现有的信用票据草稿
update-payroll-timesheet-line ：更新现有工资时间表上的一行
approve-payroll-timesheet ：批准工资时间表
revert-payroll-timesheet ：恢复已批准的工资时间表
add-payroll-timesheet-line ：在现有的工资时间表上添加新行
delete-payroll-timesheet ：删除现有的工资时间表
get-payroll-timesheet ：检索现有的工资时间表

详细API文档请参考MCP协议规范。

对于开发人员

安装

# Using npm
npm install

# Using pnpm
pnpm install

运行构建

# Using npm
npm run build

# Using pnpm
pnpm build

与 Claude Desktop 集成

要将开发中的 Xero MCP 服务器链接到 Claude Desktop，请转到“设置”>“开发人员”>“编辑配置”，然后将以下内容添加到您的claude_desktop_config.json文件中：

注意：对于 Windows，请确保args路径避开文件夹之间的\ ，即"C:\\projects\xero-mcp-server\\dist\\index.js"

{
  "mcpServers": {
    "xero": {
      "command": "node",
      "args": ["insert-your-file-path-here/xero-mcp-server/dist/index.js"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id_here",
        "XERO_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

执照

麻省理工学院

安全

请不要将您的.env文件或任何敏感凭据提交到版本控制（它作为安全默认值包含在.gitignore中。）

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

模型上下文协议服务器实现提供对 Xero 会计和业务功能的标准化访问，支持通过 MCP 进行联系人管理、发票创建和科目表管理等操作。

Related Resources

Reddit Discussion about this server

Xero MCP Server