QuickBooks Online向けの包括的なモデルコンテキストプロトコル(MCP)サーバー

クイックスタート |利用可能なツール |認証 |ドキュメント

---

概要

このMCPサーバーは、Claude Codeおよびその他のMCP互換クライアント向けのQuickBooks Online API統合を完全に提供します。29種類の事業体タイプと11の財務報告書に対する完全なCRUD操作を含み、QuickBooks Onlineの機能に包括的にアクセスできます。

主な特徴

• 145 Total Tools - QuickBooks Online APIの完全なカバー
• 29エンティティタイプ - 完全なCRUD操作(作成、読み取り、更新、削除、検索)
• 11 財務報告書 - 貸借対照表、損益表、キャッシュフローなど
• 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