QuickBooks Online용 종합 모델 컨텍스트 프로토콜(MCP) 서버

빠른 시작 | 사용 가능한 도구 | 인증 | 문서

---

개요

이 MCP 서버는 Claude Code 및 기타 MCP 호환 클라이언트에 대한 완전한 QuickBooks Online API 통합을 제공합니다. 29개의 법인 유형과 11개의 재무 보고서에 대한 완전한 CRUD 운영을 포함하여 QuickBooks Online 기능에 대한 포괄적인 접근성을 제공합니다.

주요 특징

• 145 토탈 툴 - QuickBooks Online API의 완전한 커버리지
• 29 엔터티 유형 - 완전한 CRUD 작업 (생성, 읽기, 업데이트, 삭제, 검색)
• 11 재무 보고서 - 대차대조표, 손익계산서(P&L), 현금 흐름 등
• OAuth 2.0 인증 - 안전한 토큰 기반 인증
• TypeScript - Zod의 검증을 포함한 완전한 타입 안전성
• Tested - ESM 지원이 포함된 Jest 테스트 스위트

참고: 이 서버는 로컬 MCP 서버입니다. 개발자나 파트너의 컴퓨터에서 stdio 서브프로세스로 실행되며 QuickBooks Online 회사에 인증됩니다.

시작하기 전에: 이 MCP 서버는 인증되면 실행이 쉽지만, QuickBooks Online 연동은 Intuit의 OAuth 앱 설정에 의해 제한됩니다.

QuickBooks Online MCP Server

---

Overview

This MCP server provides complete QuickBooks Online API integration for Claude Code and other MCP-compatible clients. It includes full CRUD operations for 29 entity types and 11 financial reports, giving you comprehensive access to QuickBooks Online functionality.

Key Features

• 145 Total Tools - Complete coverage of QuickBooks Online API
• 29 Entity Types - Full CRUD operations (Create, Read, Update, Delete, Search)
• 11 Financial Reports - Balance Sheet, P&L, Cash Flow, and more
• OAuth 2.0 Authentication - Secure token-based authentication
• TypeScript - Full type safety with Zod validation
• Tested - Jest test suite with ESM support

Note: this is a local MCP server. It runs as a stdio subprocess on the developer’s or partner’s machine and authenticates to a QuickBooks Online company.

Before you start: This MCP server is easy to run once authenticated, but QuickBooks Online integration is gated by Intuit’s OAuth app setup. You must register an app on the Intuit Developer Portal and complete a one-time, browser-based OAuth handshake. Sandbox supports http://localhost redirect URIs; production requires a public HTTPS callback for the initial authorization. After that initial handshake, the server runs locally without further browser interaction (until the 100-day refresh window lapses). See Authentication for full details.

---

Quick Start

Installation

# Clone the repository
git clone https://github.com/your-username/mcp-quickbooks-online.git
cd mcp-quickbooks-online

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Copy the template .env.example to .env in the root directory and fill in your values:

cp .env.example .env

QUICKBOOKS_CLIENT_ID=your_client_id
QUICKBOOKS_CLIENT_SECRET=your_client_secret
QUICKBOOKS_ENVIRONMENT=sandbox
QUICKBOOKS_REFRESH_TOKEN=your_refresh_token
QUICKBOOKS_REALM_ID=your_realm_id

# Optional: restrict which tool categories are registered (default: all enabled)
# QUICKBOOKS_DISABLE_WRITE=true    # suppress create_* tools
# QUICKBOOKS_DISABLE_UPDATE=true   # suppress update_* tools