Skip to main content
Glama
deenesjakoruzh
rjpaganini

quickbooks-mcp-server

by rjpaganini
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

quickbooks-mcp-server

QuickBooks Online에 대한 전체 읽기/쓰기 액세스를 Claude Desktop에 제공하는 단일 파일 MCP 서버로, 장부 레지스터를 스크롤하는 인간이 놓치기 쉬운 것들까지 찾아내는 조정(reconciliation) 도구를 함께 포함합니다.

$ qbo_health_check

  transport ...... stdio (Claude Desktop, Claude Code, claude.ai)
  api ............ QuickBooks Online v3
  tools .......... 22
  version ........ 2.0.0
  deploy ......... local, or HTTP on a Raspberry Pi behind Tailscale

왜 만들어졌는가

부기(bookkeeping) 질문은 거의 항상 단일 쿼리 하나로 끝나지 않습니다. *"그 거래처에 이중 결제했나?"*라는 질문은 구매 내역을 나열하고, 금액과 날짜 근접성으로 그룹을 묶고, 은행 피드와 대조한 다음, 그 중복 건이 나중에 취소되었는지 확인하는 과정을 요구합니다. 이건 하나의 루프이고, 루프는 에이전트의 몫입니다.

설계의 핵심: 불일치가 무엇을 의미하는지에 관한 판단을 모두 담은 커다란 reconcile() 함수를 만들어 주는 대신, 모델에게 작지만 조합 가능한 도구 세트를 주고 스스로 추론하게 하는 것입니다.

그 설계 때문에 v2.0.0에는 v1.0.0의 45개에서 줄어든 22개의 도구만 있습니다. 첫 번째 버전에는 내가 이 전에 던졌던 모든 질문에 대한 도구가 있었습니다. 그런데 대부분은 결국 모델이 기본 기능(primitive) 두 개를 조합하는 것에 불분명하다는 점이 밝혀졌고, 기본 기능은 남기고 복합 도구는 삭제했습니다. 이동 경로는 CHANGELOG.md를 참고하세요.

Related MCP server: penni-mcp

도구

$ qbo --list-tools

  read
    qbo_company_info            qbo_get_preferences         qbo_health_check
    qbo_list_accounts           qbo_list_customers          qbo_get_customer
    qbo_list_bills              qbo_list_deposits           qbo_get_entity
    qbo_get_invoice             qbo_get_transaction         qbo_get_transfer
    qbo_get_journal_entry       qbo_get_report              qbo_account_register

  write
    qbo_create_invoice          qbo_create_payment          qbo_create_purchase
    qbo_delete_journal_entry    qbo_delete_purchase         qbo_delete_transfer
    qbo_batch_delete

  reconciliation
    qbo_detect_bank_feed_gaps       find dates where the feed silently stopped
    qbo_find_duplicate_transactions near-match scan across amount + date window
    qbo_duplicate_scan_by_account   the same, scoped to one account
    qbo_analyze_reconciliation      month-end variance with the arithmetic shown

조정(reconciliation) 도구가 가장 가져갈 만한 가치가 있습니다. 은행 피드 공백은 아무도 잡아내지 못하는 장애 유형입니다. 피드가 4일 동안 중단되고 거래가 도착하지 않으면, 장부는 불완전한 계좌 내역과 완벽하게 균형이 맞는 상태가 됩니다. 어디에서도 오류가 발생하지 않습니다. 결국 yearld-end 결산이 맞지 않을 때 3월에야 발견하게 됩니다.

설치

$ git clone https://github.com/rjpaganini/quickbooks-mcp-server
$ cd quickbooks-mcp-server
$ pip install -r requirements.txt
$ cp .env.example .env        # then fill in your QBO app credentials

developer.intuit.com에서 앱 등록하여 클라이언트 ID와 시크릿을 발급받으세요. 필요한 것은 다음과 같습니다:

  QB_REALM_ID          your company id
  QB_CLIENT_ID         from the Intuit developer app
  QB_CLIENT_SECRET     from the Intuit developer app
  QB_REFRESH_TOKEN     from the OAuth playground
  QB_ACCESS_TOKEN      refreshed automatically once seeded
  QB_SANDBOX           true while testing — set false deliberately

그런 다음 MCP 클라이언트가 이 서버를 가리키도록 하세요:

{
  "mcpServers": {
    "quickbooks": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

안전

이 서버는 실제 회계 데이터에서 항목을 삭제할 수 있습니다. 이는 이론적인 경고가 아닙니다. qbo_batch_delete가 존재하는 이유는 잘못된 업로드된 내역을 수동으로 정리하는 것이 매우 고생스럽기 때문입니다.

실제 회사 필드에 연결하기 전에 SECURITY.md를 읽어보세요. 요약하면: 샌드박스에서 시작하고, 작동하는 것을 확인할 때까지 QB_SANDBOX=true를 유지하고, 쓰기·삭제 도구는 와일드카드가 붙은 rm과 동일하게 조심히 다루라는 것입니다.

$ pytest                       # unit tests, no network
$ pytest -m live               # smoke tests against a live sandbox company

참고

  • 의도적으로 단일 파일로 구성했습니다. server.py는 크지만 전체를 grep할 수 있고, 머릿속에 import 그래프를 유지할 필요가 없습니다.

  • Raspberry Pi에서는 deploy-to-pi.sh를 통해 HTTP 서비스로도 실행할 수 있으며, 저는 Tailscale Android 위에서 휴대전화의 claude.ai로 여기에서 접근할 때 이 방법을 사용합니다.

  • 이 저장소에는 자격 증명, 회사 데이터, 금융 기록이 없습니다.

라이선스

MIT.

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • QuickBooks Online MCP Server

    hakeemrabiuDFW
    A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to query and manage QuickBooks Online data through natural language, including customers, invoices, bills, vendors, accounts, and financial reports.
    7
    MIT

  • penni-mcp

    CWhittemore1010
    A
    license
    A
    quality
    D
    maintenance
    AI bookkeeper for small businesses that connects to QuickBooks Online. Enables users to query financial data like bank balances, P\&L reports, and invoices through natural language in Claude Desktop or Cursor.
    6
    49
    MIT

  • quickbooks-mcp-server

    NyxToolsDev
    A
    license
    Not graded
    quality
    D
    maintenance
    Connect Claude Desktop and Claude Code to QuickBooks Online for natural-language accounting. Ask questions about invoices, expenses, reports, and more using plain English.
    MIT

  • QuickBooks Online MCP Server

    Brax-Tech-Internal
    A
    license
    C
    quality
    B
    maintenance
    Provides complete QuickBooks Online API integration for Claude Code and other MCP-compatible clients, enabling full CRUD operations on 29 entity types and 11 financial reports.
    100
    Apache 2.0

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rjpaganini/quickbooks-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server