Xero MCP 服务器

Name: Xero MCP Server
Author: XeroAPI

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

特征

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

Related MCP server: ABAP-ADT-API MCP-Server

先决条件

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中。）

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

Xero MCP Server