Xero

Xero MCP 服务

这是面向 Xero 的模型上下文协议（MCP）服务实现。它在 MCP 协议与 Xero API 之间提供桥接，从而以标准化方式访问 Xero 的会计和业务功能。

来源

此软件包是 Mindstone 维护的 Xero 社区版 Xero MCP 服务构建版本，该服务已在 Xero 开发者博客上公布，并在上游 XeroAPI/xero-mcp-server 开发。此版本在上游项目的基础上加入了 Mindstone 的改进和加固。

一键安装

点击按钮后，宿主会提示你填写：XERO_CLIENT_ID、XERO_CLIENT_SECRET、XERO_CLIENT_BEARER_TOKEN。

{
  "mcpServers": {
    "Xero": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-xero"
      ],
      "env": {
        "XERO_CLIENT_ID": "",
        "XERO_CLIENT_SECRET": "",
        "XERO_CLIENT_BEARER_TOKEN": ""
      }
    }
  }
}

功能

• 使用自定义连接进行 Xero OAuth2 身份验证
• 联系人管理
• 会计科目表管理
• 发票创建和管理
• 符合 MCP 协议规范

前提条件

• Node.js（v20 或更高版本）
• npm 或 pnpm
• 拥有 API 凭据的 Xero 开发者账户

文档和链接

• Xero 公共 API 文档
• Xero API 浏览器
• Xero OpenAPI 规范
• Xero-Node 公共 API SDK 文档
• 开发者文档

设置

创建 Xero 账户

如果你还没有 Xero 账户和组织，可以通过使用免费试用，在此处注册创建。

我们建议先使用演示公司，因为其中预加载了一些示例数据。登录后，使用左上角的下拉菜单并选择“演示公司”即可切换到该公司。你可以随时使用左上角的下拉菜单并前往 My Xero，重置演示公司的数据或更改国家/地区。

注意：要使用 Payroll 专用查询，地区应为 NZ 或 UK。

身份验证

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

1. 自定义连接

这更适合测试和开发，可让你为特定组织指定客户端 ID 和密钥。 如果你要将其集成到 Claude Desktop 等第三方 MCP 客户端中，我们也建议采用此方式。

配置 Xero Developer 账户

按照以下说明设置 Custom Connection：https://developer.xero.com/documentation/guides/oauth2/custom-connections/

目前，Custom Connection 会话需要以下 scopes：scopes

将 MCP 服务集成到 Claude Desktop

要将 MCP 服务添加到 Claude，请前往“设置”>“开发者”>“编辑配置”，并将以下内容添加到 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-xero@latest"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id_here",
        "XERO_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

注意：如果你使用 Node Version Manager，请将 "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", "@mindstone/mcp-server-xero@latest"],
      "env": {
        "XERO_CLIENT_BEARER_TOKEN": "your_bearer_token"
      }
    }
  }
}

注意：如果已定义，XERO_CLIENT_BEARER_TOKEN 的优先级高于 XERO_CLIENT_ID。

可用的 MCP 命令

工具命名： 此连接器的工具使用未加前缀的短横线命名（例如 list-invoices、create-contact），沿袭自其分支来源。其同系列连接器使用带前缀的 snake_case 命名（例如 list_quickbooks_invoices）。在多服务主机中，未加前缀的通用名称可能会与其他服务的工具冲突。重命名会破坏现有配置，因此名称保持不变；如果你的主机支持命名空间或别名，建议为此服务启用该功能。

• list-accounts：获取账户列表
• list-contacts：获取 Xero 中的联系人列表
• list-credit-notes：获取贷项通知单列表
• list-invoices：获取发票列表
• list-items：获取项目列表
• list-organisation-details：获取组织详情
• list-profit-and-loss：获取损益报告
• list-bank-summary：获取银行汇总报告（各账户的余额和变动）
• list-budget-summary：获取预算汇总报告（预算与实际情况对比）
• list-executive-summary：获取执行摘要报告（关键财务指标概览）
• list-quotes：获取报价单列表
• list-tax-rates：获取税率列表
• list-payments：获取付款列表
• list-trial-balance：获取试算平衡表报告
• list-profit-and-loss：获取损益报告
• list-bank-transactions：获取银行账户交易列表
• list-payroll-employees：获取 Payroll 员工列表
• list-report-balance-sheet：获取资产负债表报告
• list-payroll-employee-leave：获取 Payroll 员工的休假记录
• list-payroll-employee-leave-balances：获取 Payroll 员工的休假余额
• list-payroll-employee-leave-types：获取 Payroll 休假类型列表
• list-payroll-leave-periods：获取 Payroll 员工的休假期间列表
• list-payroll-leave-types：获取 Xero Payroll 中所有可用的休假类型列表
• list-aged-receivables-by-contact：获取联系人的账龄应收款
• list-aged-payables-by-contact：获取联系人的账龄应付款
• list-contact-groups：获取联系人群组列表
• list-currencies：获取已在所连接的 Xero 组织中启用的货币
• list-invoice-attachments：获取附加到 Xero 发票的文件
• list-purchase-orders：获取采购订单列表
• create-contact：创建新联系人
• create-credit-note：创建新的贷项通知单
• create-invoice：创建新发票。如果所连接的 Xero 组织已启用相应货币，则支持使用可选参数 currencyCode，例如 USD。
• create-payment：创建新付款
• create-quote：创建新报价单
• create-purchase-order：创建新采购订单
• create-credit-note：创建新的贷项通知单
• create-payroll-timesheet：创建新的 Payroll 工时表
• update-contact：更新现有联系人
• update-invoice：更新现有草稿发票。如果所连接的 Xero 组织已启用相应货币，则支持使用可选参数 currencyCode，例如 USD。
• update-quote：更新现有草稿报价单
• update-credit-note：更新现有草稿贷项通知单
• get-invoice-history：获取发票的历史记录
• add-invoice-note：向发票历史记录添加不可更改的备注
• get-contact-history：获取联系人的历史记录
• add-contact-note：向联系人历史记录添加不可更改的备注
• get-credit-note-history：获取贷项通知单的历史记录
• add-credit-note-note：向贷项通知单历史记录添加不可更改的备注
• get-bank-transaction-history：获取银行交易的历史记录
• add-bank-transaction-note：向银行交易历史记录添加不可更改的备注
• get-quote-history：获取报价单的历史记录
• add-quote-note：向报价单历史记录添加不可更改的备注
• update-payroll-timesheet-line：更新现有 Payroll 工时表中的一行
• approve-payroll-timesheet：批准 Payroll 工时表
• revert-payroll-timesheet：撤销已批准的 Payroll 工时表
• add-payroll-timesheet-line：向现有 Payroll 工时表添加新行
• delete-payroll-timesheet：删除现有 Payroll 工时表
• get-payroll-timesheet：获取现有 Payroll 工时表
• email-invoice：将一份已授权发票的副本通过电子邮件发送给相关联系人 有关详细的 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，请前往 Settings > Developer > Edit config，并将以下内容添加到你的 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"
      }
    }
  }
}

许可证

MIT

安全

请勿将你的 .env 文件或任何敏感凭据提交到版本控制中（为确保安全，.gitignore 中已包含该文件。）