quickbooks-online-mcp-server — Claude Code skill: setup guide
Connects coding assistants to a QuickBooks Online MCP server to handle bookkeeping entities and inspect accounting reports.
no license 166 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a claude-codeWhat quickbooks-online-mcp-server 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.
What it helps with
- 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 for the agent
- 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
How to install quickbooks-online-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/quickbooks-online-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/quickbooks-online-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a codex2Manually: put the files in place
.agents/skills/quickbooks-online-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/quickbooks-online-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/quickbooks-online-mcp-server2Manually: put the files in place
.github/skills/quickbooks-online-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/quickbooks-online-mcp-serverManually: put the files in place
.devin/skills/quickbooks-online-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about quickbooks-online-mcp-server
How do I install quickbooks-online-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill quickbooks-online-mcp-server -a claude-code.
What features does quickbooks-online-mcp-server offer?
It exposes 144 MCP tools across 29 business entities and provides generators for 11 financial statements.
What environment variables does the server need?
You must provide QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, QUICKBOOKS_REALM_ID, and a valid QUICKBOOKS_REFRESH_TOKEN.