quickbooks-auth

Manage OAuth tokens and authentication for QuickBooks connections.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/ticruz38/skills --skill quickbooks-auth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quickbooks-auth
Source: https://github.com/ticruz38/skills/tree/main/skills/quickbooks-auth
Command: npx skills add https://github.com/ticruz38/skills --skill quickbooks-auth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QuickBooks integration with OAuth can be complex, requiring secure token storage, automatic refresh, and multi-profile management; this skill provides a ready-to-use adapter built on the auth-provider, handling the heavy lifting.

Core Features & Use Cases

  • Multi-Profile support for managing multiple QuickBooks company connections from a single user.
  • Sandbox/Production toggle to safely develop and deploy with real data separation.
  • Automatic token refresh, health checks, and Realm ID management to keep connections healthy.
  • Simplified API client with environment-aware base URL and fetch helper for QuickBooks endpoints. Use cases include onboarding multiple clients, maintaining persistent connections, and performing read/write operations against company data (invoices, customers, etc.) with a single cohesive interface.

Quick Start

Initiate the OAuth flow for a profile and complete it using the CLI.

Frequently Asked Questions about quickbooks-auth

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage QuickBooks OAuth tokens for multiple company profiles?

QuickBooks OAuth token management for multiple profiles is handled through an auth-provider adapter that stores tokens, tracks Realm IDs, and isolates connections per company profile.

How do I handle QuickBooks API authentication across sandbox and production environments?

QuickBooks API authentication across sandbox and production uses an environment-aware base URL toggle, allowing safe development and deployment with real data separation within the same client.

Can I automatically refresh expired QuickBooks OAuth tokens?

Yes, expired QuickBooks OAuth tokens are automatically refreshed using the TypeScript/JavaScript auth-provider adapter, ensuring persistent connections without manual re-authentication.

What's the best way to run health checks on QuickBooks API connections?

Running health checks on QuickBooks API connections is built into the authentication adapter, which verifies token validity and connection status before executing read or write operations.

How do I make authenticated fetch requests to the QuickBooks API?

Authenticated fetch requests to the QuickBooks API are executed via a built-in fetch helper that attaches valid OAuth tokens automatically for operations like reading invoices or managing customers.

Do I need an auth-provider to use QuickBooks OAuth integration?

Yes, an auth-provider is required as the foundational dependency, because the QuickBooks OAuth integration stores tokens and manages automatic refresh cycles directly through this interface.