myob-api-integration

Original：🇺🇸 English

Translated

Read-only MYOB AccountRight and Essentials API access for historical transaction data extraction

1installs

Sourcecleanexpo/ato

Added on2026-02-15

NPX Install

npx skill4agent add cleanexpo/ato myob-api-integration

SKILL.md Content

View Translation Comparison →

MYOB API Integration Skill

Provides read-only access to MYOB accounting data through the MYOB API. Extracts historical transactions, chart of accounts, contacts, and financial reports for tax analysis.

When to Use

Connecting a MYOB client for tax analysis (instead of Xero)
Extracting historical transaction data from MYOB
Fetching chart of accounts for GL mapping
Pulling profit & loss and balance sheet reports
Multi-year data sync for carry-forward analysis

Integration Architecture

MYOB API → myob-adapter.ts → canonical-schema.ts → analysis engines

All MYOB data is normalised to the canonical schema (

lib/integrations/canonical-schema.ts

) before being consumed by analysis engines. This ensures all 16 engines work identically regardless of whether data comes from Xero, MYOB, or QuickBooks.

Key Files

Adapter:

lib/integrations/adapters/myob-adapter.ts

— MYOB API client

Historical Fetcher:

lib/integrations/myob-historical-fetcher.ts

— Multi-year data sync

Canonical Schema:
```
lib/integrations/canonical-schema.ts
```
— Normalised data model
Config:
```
lib/integrations/myob-config.ts
```
— OAuth configuration
Auth Route:
```
app/api/auth/myob/route.ts
```
— OAuth 2.0 callback

Access Scopes

All access is read-only:

General Ledger transactions
Chart of accounts
Contacts
Bank transactions
Payroll data (if available)

Data Normalisation

MYOB Field	Canonical Field	Notes
UID	externalId	MYOB unique identifier
DisplayID	reference	Account/transaction code
Date	date	ISO 8601
Total/Amount	amount	Decimal precision preserved
Account.DisplayID	accountCode	GL account code
Contact.DisplayID	contactId	Contact reference

OAuth Flow

User clicks "Connect MYOB"
Redirect to MYOB OAuth consent screen
User grants read-only access
Callback stores encrypted tokens
Select company file (MYOB-specific)
Begin historical data sync