← Back to Skills Marketplace
byungkyu

xero

by byungkyu · GitHub ↗ · v1.2.0 · MIT-0
cross-platform ✓ Security Clean
19690
Downloads
12
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install xero
Description
Xero API integration with managed OAuth. Manage contacts, invoices, payments, accounts, and run financial reports. Use this skill when users want to interact with Xero accounting data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login; default to read and list calls, and confirm every write or new connection with the user.
Usage Guidance
Before installing, confirm you are comfortable routing Xero requests through Maton and granting access to the specific Xero tenant needed. Treat write operations as high impact: review the exact resource, payload, and target connection before approving any change.
Capability Assessment
Credentials
The skill uses network access, Bash, and managed OAuth credentials to reach Xero through api.maton.ai, which is proportionate for a third-party accounting API integration but involves sensitive financial data.
Install Mechanism
Installation requires the external Maton CLI via npm or Homebrew, with an optional SDK/raw HTTP fallback; this is disclosed and aligned with the integration purpose.
Instruction Scope
The instructions default to read/list operations, require explicit user approval for new connections and all POST/PUT/PATCH/DELETE actions, and advise specifying the exact connection when multiple accounts exist.
Persistence & Privilege
Credential persistence is disclosed as OS credential-store use by the Maton CLI, and the skill explicitly warns not to inspect, print, export, log, or persist credentials elsewhere.
Purpose & Capability
The stated purpose is to access and manage Xero accounting data, and the documented capabilities match that purpose: contacts, invoices, payments, accounts, bank transactions, and reports.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install xero
  3. After installation, invoke the skill by name or use /xero
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.5
- Updated all API endpoint URLs to use https://api.maton.ai instead of previous gateway or ctrl domains. - Clarified connection management instructions to match new API base URL. - Added explicit note in the connection section: always set the Maton-Connection header if you have multiple connections. - Added a new Security & Permissions section noting that all write operations require explicit user approval. - Removed LICENSE.txt file.
v1.0.4
- Added a new clawdbot metadata section to the skill manifest, specifying an emoji and required environment variable (MATON_API_KEY). - No changes to functionality or documentation content.
v1.0.3
xero 1.0.3 Changelog - Improved troubleshooting section: clarified distinction between API key issues and invalid app name errors. - Added guidance to ensure URL paths start with "xero" for proper app routing. - No code or functional changes; documentation update only.
v1.0.2
- Added guidance for using the api-gateway skill for other third-party apps. - Replaced all shell cURL connection management examples with Python (urllib) examples for better portability and reliability with environment variables. - Added troubleshooting advice and an expanded section to help resolve "Invalid API key" errors, including verification steps. - Included important notes about using curl with brackets (requiring curl -g) and potential environment variable expansion issues when piping to other commands (like jq). - No changes to functionality or code, documentation updates only.
v1.0.1
- Updated the base URL documentation to use /xero/{native-api-path} and clarified endpoint usage. - Added instructions for specifying a connection with the Maton-Connection header, including behavior for multiple connections. - Expanded example connection response details, including creation_time, last_updated_time, and metadata fields. - Clarified API key acquisition (sign in or create an account) and endpoint documentation. - No functional changes to the skill logic; documentation improvements only.
v1.0.0
Initial release: Integrate Xero accounting API with managed OAuth, supporting contacts, invoices, payments, accounts, bank transactions, and financial reports. - Secure Xero API access via Maton-managed OAuth and API key. - Manage Xero OAuth connections via web dashboard or API. - Includes endpoints for contacts, invoices, payments, accounts, bank transactions, and core financial reports. - Provides sample code for bash, JavaScript, and Python. - Automatic handling of authentication headers and error codes.
Metadata
Slug xero
Version 1.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 8
Frequently Asked Questions

What is xero?

Xero API integration with managed OAuth. Manage contacts, invoices, payments, accounts, and run financial reports. Use this skill when users want to interact with Xero accounting data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login; default to read and list calls, and confirm every write or new connection with the user. It is an AI Agent Skill for Claude Code / OpenClaw, with 19690 downloads so far.

How do I install xero?

Run "/install xero" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is xero free?

Yes, xero is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does xero support?

xero is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created xero?

It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.0.

💬 Comments