Комплексный сервер Model Context Protocol (MCP) для QuickBooks Online

Быстрый старт | Доступные инструменты | Аутентификация | Документация

---

Обзор

Этот MCP-сервер обеспечивает полную интеграцию QuickBooks Online API для Claude Code и других совместимых с MCP клиентов. Он включает полные операции с CRUD-файлами для 29 типов сущностей и 11 финансовых отчётов, предоставляя вам полный доступ к функциональности QuickBooks Online.

Ключевые особенности

• 145 Всего инструментов - Полное освещение API QuickBooks Online
• 29 типов сущностей — полные операции CRUD-структуры (создание, чтение, обновление, удаление, поиск)
• 11 Финансовые отчёты - Баланс, прибыль и убытки, денежные потоки и многое другое
• OAuth 2.0 Аутентификация - Защищённая аутентификация на основе токенов
• TypeScript - Полная безопасность шрифта с валидацией Zod
• Проверено — тестовый набор Jest с поддержкой ESM

Примечание: это локальный сервер MCP. Он работает как подпроцесс stdio на машине разработчика или партнёра и аутентифицируется в компании QuickBooks Online.

Перед началом: Этот MCP-сервер легко запускать после аутентификации, но интеграция с QuickBooks Online ограничена настройками приложения OAuth от Intuit.

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