QuickBooks Online MCP Server
Официальный локальный MCP-сервер Intuit: агент ищет и создает счета, платежи и контрагентов в QuickBooks Online, строит отчеты
- 436 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Сервер видит финансовые данные компании: счета, платежи, проводки, сведения о сотрудниках, контрагентах и налоговые коды
- Инструменты создания, правки и удаления меняют настоящий учет, а удаленный счет или платеж вернуть непросто
- Секрет приложения и токен обновления лежат в .env открытым текстом, а токен перезаписывается при каждом продлении
Установка
- Работает в
Ручная установка
git clone https://github.com/intuit/quickbooks-online-mcp-server.git && cd quickbooks-online-mcp-server && npm install && npm run buildЗатем скопируйте .env.example в .env, впишите ключи приложения Intuit и получите токен командой `npm run auth`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер видит финансовые данные компании: счета, платежи, проводки, сведения о сотрудниках, контрагентах и налоговые коды
- Инструменты создания, правки и удаления меняют настоящий учет, а удаленный счет или платеж вернуть непросто
- Секрет приложения и токен обновления лежат в .env открытым текстом, а токен перезаписывается при каждом продлении
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает ИИ-агента к учетной системе QuickBooks Online через официальный API. Он запускается на вашей машине как процесс stdio и входит в компанию QuickBooks по OAuth 2.0. Для 29 типов сущностей, среди которых клиенты, счета, оплаты, поставщики, сотрудники, проводки и налоговые коды, есть операции создания, чтения, изменения, удаления и поиска. Налоговые коды, ставки и агентства доступны только на чтение. Кроме записей сервер строит 11 финансовых отчетов: баланс, прибыли и убытки, движение денег, оборотно-сальдовый отчет, главную книгу, продажи по клиентам, суммы к получению и к оплате с разбивкой по срокам. Счет можно получить как PDF. Агент либо вернет файл в виде base64, либо сохранит его в папку, заданную переменной QBO_PDF_OUTPUT_DIR. На переменных окружения можно отключить целые группы инструментов: QUICKBOOKS_DISABLE_WRITE убирает создание, QUICKBOOKS_DISABLE_UPDATE правку, QUICKBOOKS_DISABLE_DELETE удаление. Инструменты чтения и поиска остаются всегда.
Для кого. Для бухгалтеров, финансовых директоров и разработчиков, которые ведут учет в QuickBooks Online и хотят поручить Claude Code выборки, сверки и отчеты.
Подходит, если
- Нужно найти неоплаченные счета клиента и получить отчет по суммам к получению с разбивкой по срокам
- Баланс или отчет о прибылях и убытках за период надо выгрузить и разобрать вместе с агентом
- Серию клиентов, счетов или поставщиков надо завести по списку, а вручную в интерфейсе это долго
- Разработчик отлаживает интеграцию с QuickBooks на тестовой компании в режиме sandbox и хочет быстро смотреть данные
- PDF счета агент сохраняет в заданную папку
Не подходит, если
- Вы ведете учет в другой системе: сервер работает только с QuickBooks Online
- Агенту нельзя доверять изменение учета, а переменные отключения записи вы настраивать не готовы
- Нужна установка в один шаг из реестра пакетов: сервер ставится из исходников и требует собственного приложения Intuit
- Нужен общий доступ команды к одному серверу: он запускается локальным процессом stdio на одной машине
Пример запроса к агенту
Найди все неоплаченные счета клиента Acme за последние 90 дней и покажи отчет по суммам к получению с разбивкой по срокамMCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
QUICKBOOKS_CLIENT_IDобязательная- Идентификатор приложения со страницы Keys & Credentials в Intuit Developer Portal
QUICKBOOKS_CLIENT_SECRETобязательная, секрет- Секрет приложения оттуда же
QUICKBOOKS_REFRESH_TOKENобязательная, секрет- Токен обновления, который выдает `npm run auth`
QUICKBOOKS_REALM_IDобязательная- Идентификатор компании QuickBooks
QUICKBOOKS_ENVIRONMENTобязательная- Среда: sandbox или production
QUICKBOOKS_DISABLE_WRITE- true убирает инструменты создания
QUICKBOOKS_DISABLE_UPDATE- true убирает инструменты правки
QUICKBOOKS_DISABLE_DELETE- true убирает инструменты удаления
QUICKBOOKS_TOKEN_STORE_PATH- Путь для хранения обновляемого токена, если файловая система только для чтения
QBO_PDF_OUTPUT_DIR- Папка, куда сервер сохраняет PDF счетов вместо ответа в base64
Ограничения
- Доступ идет через приложение, которое надо зарегистрировать в Intuit Developer Portal. Персональных ключей API у Intuit нет, так что обойти OAuth нельзя. Для первого запуска проще взять тестовую компанию sandbox.
- Для настоящей компании портал отклоняет redirect URI с localhost. Нужен публичный HTTPS-адрес, например временный туннель ngrok, и только для разового обмена кодом на токен.
- Нужен Node.js, сервер собирается командами `npm install` и `npm run build`. Опубликованного готового пакета в инструкции нет.
- Для удаления доступно не все: у счетов, классов, отделов, условий оплаты и способов оплаты удаления нет, а налоговые сущности доступны только на чтение.
- Токен обновления сервер переписывает в файл при каждом продлении, поэтому на файловой системе только для чтения нужна переменная QUICKBOOKS_TOKEN_STORE_PATH.
Как отключить. Уберите запись quickbooks из конфига MCP-клиента. Чтобы закрыть доступ полностью, удалите файл .env с ключами и отзовите токен приложения в Intuit Developer Portal.
Частые вопросы
Как подключить QuickBooks Online к Claude Code?
Соберите сервер из исходников, заполните .env ключами приложения из Intuit Developer Portal и получите токен командой `npm run auth`. Затем добавьте в конфиг MCP запись с командой node, путем к dist/index.js и переменными QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, QUICKBOOKS_REFRESH_TOKEN, QUICKBOOKS_REALM_ID и QUICKBOOKS_ENVIRONMENT.
Можно ли запретить агенту менять данные в QuickBooks?
Да. Поставьте в true переменные QUICKBOOKS_DISABLE_WRITE, QUICKBOOKS_DISABLE_UPDATE и QUICKBOOKS_DISABLE_DELETE, и инструменты создания, правки и удаления не зарегистрируются. Чтение и поиск останутся доступны.
Почему для рабочей компании не подходит адрес localhost при авторизации?
В режиме production портал Intuit отклоняет redirect URI с localhost, для него нужен публичный HTTPS-адрес. Для тестовой компании подходит http://localhost:8000/callback. Токен обновления после первого обмена хранится в .env, и публичный адрес для повседневной работы уже не нужен.
Какие отчеты умеет строить сервер?
Одиннадцать: баланс, прибыли и убытки, движение денег, оборотно-сальдовый, главная книга, продажи по клиентам, баланс клиентов, расходы по поставщикам, а также суммы к получению и к оплате, причем у отчета по суммам к получению есть и подробный вариант. Названия инструментов начинаются с get_, например get_balance_sheet.
Куда сервер пишет обновленный токен?
В .env рядом с собранным модулем: путь считается от модуля, а не от рабочей папки оболочки. В контейнере с файловой системой только для чтения задайте QUICKBOOKS_TOKEN_STORE_PATH, и токен пойдет туда.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP ЮKassa: агент создает ссылки на оплату и счета, проверяет статусы и возвраты, но сам деньги не переводит
MCP-сервер для данных 1С:Предприятия через OData: дебиторка, продажи, остатки и деньги, а по отдельному флагу создание и проведение документов
Официальный MCP Точка Банка: агент смотрит счета и балансы, собирает выписки и готовит платежи, которые вы подписываете в интернет-банке
MCP-сервер Paddle Billing
MCP Server for Paddle Billing
Официальный MCP-сервер Paddle Billing: каталог, клиенты, транзакции, подписки и отчеты через агента с фильтром опасных операций
MCP-сервер 1С:Фреш на Python
1c-fresh-mcp
MCP-сервер для 1С:Фреш через стандартный OData: счета, продажи, контрагенты, обходит известные ограничения OData 1С:Фреш и учитывает НДС 22 процента
MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| QuickBooks Online MCP Server (эта запись) | да | OAuth | 436 | |
| MCP-сервер Контур.Эльбы | нет | API-ключ | 0 | работает с Контур.Эльбой: контрагенты, счета, акты и накладные, а этот сервер подключается к QuickBooks Online, где есть проводки, оборотно-сальдовый отчет и баланс |
| MCP-сервер для Контур.Эльбы | нет | API-ключ | 0 | сервер для Контур.Эльбы, у него другая учетная система и набор документов |
Коротко о README
Страница описывает возможности сервера, быструю установку и пример конфига для Claude Code, затем перечисляет сущности, отчеты и инструменты. Отдельный раздел объясняет настройку OAuth для тестовой и рабочей компании с типичными ловушками. Внизу идут сборка, тесты, структура проекта и правила именования инструментов.