What OAuth scopes are required for this Xero skill?

To function correctly, the skill requires openid, profile, email, accounting.reports.read, and offline_access scopes.

Can I use this with Xero client credentials?

Yes, the skill supports the MCP connect workflow which allows for both XERO_MCP_CLIENT_BEARER_TOKEN and XERO_MCP_CLIENT_ID/SECRET configurations.

How does this skill handle empty report lists from the Xero API?

It implements a direct probe workflow that bypasses the generic /Reports endpoint to check specific known endpoints like TrialBalance and BalanceSheet directly.

Does this skill help with data normalization?

Yes, it provides a specific flow to normalize raw Xero report data into standard fields including account_code, period, and signed net amounts.

Is it safe to use my Xero tokens with this skill?

The skill includes specific guardrails advising against logging secrets in plaintext and recommending secure storage for refresh tokens and tenant IDs.

Xero API & MCP Connector

Name: Xero API & MCP Connector
Author: bashiraziz

bybashiraziz

0•

API 开发

Automates Xero API authentication, report discovery, and financial data extraction through standardized MCP workflows.

This skill provides a comprehensive framework for Claude to interact with the Xero accounting platform using both standard REST API calls and Model Context Protocol (MCP) connections. It streamlines the complex OAuth 2.0 handshake and tenant selection process, while offering specialized workflows for discovering financial reports and pulling trial balance data. Designed for developers building financial agents or reconciliation tools, it includes robust troubleshooting routines for common API hurdles like empty report lists and scope misconfigurations, ensuring reliable data access for accounting automation tasks.

主要功能

01Multi-mode MCP connectivity for bearer tokens or client credentials

02Data normalization for trial balance outputs into structured formats

03Deep report discovery for Trial Balances, P&L, and Balance Sheets

04Automated troubleshooting for '0 reports' and token expiration scenarios

050 GitHub stars

06Standardized OAuth 2.0 and tenant selection workflow automation

使用场景

01Building AI-driven financial reporting dashboards and analytics

02Automating monthly trial balance pulls for accounting reconciliation

03Debugging Xero API connection issues and scope misconfigurations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bashiraziz/acctreconagents xero-api-mcp-generic

For use in Claude.ai and ChatGPT

主要功能

01Multi-mode MCP connectivity for bearer tokens or client credentials

02Data normalization for trial balance outputs into structured formats

03Deep report discovery for Trial Balances, P&L, and Balance Sheets

04Automated troubleshooting for '0 reports' and token expiration scenarios

050 GitHub stars

06Standardized OAuth 2.0 and tenant selection workflow automation

使用场景

01Building AI-driven financial reporting dashboards and analytics

02Automating monthly trial balance pulls for accounting reconciliation

03Debugging Xero API connection issues and scope misconfigurations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bashiraziz/acctreconagents xero-api-mcp-generic

For use in Claude.ai and ChatGPT