# quickbooks-online-mcp-server

Connects coding assistants to a QuickBooks Online MCP server to handle bookkeeping entities and inspect accounting reports.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 166 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/quickbooks-online-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/quickbooks-online-mcp-server

## What it does

This skill guides the setup of an MCP server dedicated to QuickBooks Online bookkeeping. It supplies 144 tools spanning 29 accounting entity types, such as vendors, invoices, payments, bills, and customers. Assistants can also request 11 standard accounting summaries, including balance sheets and cash flow statements with custom parameters.

The server runs on TypeScript and relies on Zod schemas to validate tool inputs before dispatch. It operates against both Intuit sandbox workspaces and live production environments.

Without an active Intuit developer account and an OAuth 2.0 refresh token, the server cannot connect to company ledgers. Updating existing entities requires passing the correct `SyncToken` returned by previous read calls.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/quickbooks-online-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/quickbooks-online-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/quickbooks-online-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/quickbooks-online-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/quickbooks-online-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/quickbooks-online-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/quickbooks-online-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/quickbooks-online-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/quickbooks-online-mcp-server/SKILL.md

## When to use it
- generate and update customer invoices from chat prompts
- pull profit and loss or balance sheet statements on schedule
- query customer and vendor directories with custom filters
- track pending payments and open balance amounts

## Example prompts
- Find all unpaid customer invoices in QuickBooks for this month
- Create a new customer profile for Acme Corp inside QuickBooks
- Fetch the latest quarterly cash flow statement via QuickBooks

## Similar
- [QuickBooks Online](https://affpapa.org/en/nevibecode/mcp/quickbooks-online.md) — MCP server · ★ 14 repo stars
- [connector-quickbooks](https://affpapa.org/en/nevibecode/skills/connector-quickbooks.md) — skill · 10200 installs
- [QuickBooks Online MCP](https://affpapa.org/en/nevibecode/mcp/quickbooks-online-mcp.md) — MCP server · ★ 87 repo stars
- [quickbooks](https://affpapa.org/en/nevibecode/skills/quickbooks.md) — skill · 338 installs
- [QuickBooks Automation](https://affpapa.org/en/nevibecode/skills/quickbooks-automation.md) — skill · 4900 installs
- [quickbooks-mcp](https://affpapa.org/en/nevibecode/mcp/quickbooks-mcp.md) — MCP server · ★ 13 repo stars

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
