QuickBooks Online — MCP-сервер для Claude Code
MCP-сервер связывает ИИ-агента с QuickBooks Online: он работает со счетами, клиентами, поставщиками и финансовыми отчётами.
claude mcp add --env QUICKBOOKS_CLIENT_ID=<QUICKBOOKS_CLIENT_ID> --env QUICKBOOKS_CLIENT_SECRET=<QUICKBOOKS_CLIENT_SECRET> --env QUICKBOOKS_REFRESH_TOKEN=<QUICKBOOKS_REFRESH_TOKEN> --env QUICKBOOKS_REALM_ID=<QUICKBOOKS_REALM_ID> --env QUICKBOOKS_ENVIRONMENT=<QUICKBOOKS_ENVIRONMENT> --transport stdio quickbooks -- npx -y @mindstone/mcp-server-quickbooksЧто делает QuickBooks Online
QuickBooks Online даёт агенту доступ к данным и операциям в QuickBooks Online через MCP. Сервер умеет искать и получать сущности, выполнять запросы на языке QuickBooks Query Language, запускать отчёты ProfitAndLoss, BalanceSheet, CashFlow, AgedReceivables и AgedPayables. Также доступны счета, оценки, клиенты и поставщики.
В сервере 21 инструмент: среди них создание и обновление счетов, клиентов и поставщиков, отправка счёта по email и загрузка его в PDF. OAuth настраивается переменными QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, QUICKBOOKS_REFRESH_TOKEN, QUICKBOOKS_REALM_ID и QUICKBOOKS_ENVIRONMENT. Нужны Node.js 20+ и npm.
Запись в QuickBooks включена по умолчанию для изменяющих инструментов, а подтверждение операции зависит от слоя согласования хоста. Без OAuth-параметров сервер не подключится к компании QuickBooks Online, поэтому их нужно подготовить до настройки MCP.
Какие задачи решает
- получить данные о клиентах и поставщиках
- создать или обновить счёт в QuickBooks Online
- сформировать финансовый отчёт
- отправить счёт клиенту по email
- скачать счёт в PDF
Примеры запросов агенту
- Найди неоплаченные счета в QuickBooks Online и покажи их клиентов и суммы.
- Создай в QuickBooks Online счёт для указанного клиента с этими позициями.
- Сформируй отчёт AgedReceivables и объясни просроченные суммы.
Как установить QuickBooks Online
Командой платформы
claude mcp add --env QUICKBOOKS_CLIENT_ID=<QUICKBOOKS_CLIENT_ID> --env QUICKBOOKS_CLIENT_SECRET=<QUICKBOOKS_CLIENT_SECRET> --env QUICKBOOKS_REFRESH_TOKEN=<QUICKBOOKS_REFRESH_TOKEN> --env QUICKBOOKS_REALM_ID=<QUICKBOOKS_REALM_ID> --env QUICKBOOKS_ENVIRONMENT=<QUICKBOOKS_ENVIRONMENT> --transport stdio quickbooks -- npx -y @mindstone/mcp-server-quickbooksВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add quickbooks --env QUICKBOOKS_CLIENT_ID=<QUICKBOOKS_CLIENT_ID> --env QUICKBOOKS_CLIENT_SECRET=<QUICKBOOKS_CLIENT_SECRET> --env QUICKBOOKS_REFRESH_TOKEN=<QUICKBOOKS_REFRESH_TOKEN> --env QUICKBOOKS_REALM_ID=<QUICKBOOKS_REALM_ID> --env QUICKBOOKS_ENVIRONMENT=<QUICKBOOKS_ENVIRONMENT> -- npx -y @mindstone/mcp-server-quickbooksВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"quickbooks": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-quickbooks"
],
"env": {
"QUICKBOOKS_CLIENT_ID": "<QUICKBOOKS_CLIENT_ID>",
"QUICKBOOKS_CLIENT_SECRET": "<QUICKBOOKS_CLIENT_SECRET>",
"QUICKBOOKS_REFRESH_TOKEN": "<QUICKBOOKS_REFRESH_TOKEN>",
"QUICKBOOKS_REALM_ID": "<QUICKBOOKS_REALM_ID>",
"QUICKBOOKS_ENVIRONMENT": "<QUICKBOOKS_ENVIRONMENT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"quickbooks": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-quickbooks"
],
"env": {
"QUICKBOOKS_CLIENT_ID": "<QUICKBOOKS_CLIENT_ID>",
"QUICKBOOKS_CLIENT_SECRET": "<QUICKBOOKS_CLIENT_SECRET>",
"QUICKBOOKS_REFRESH_TOKEN": "<QUICKBOOKS_REFRESH_TOKEN>",
"QUICKBOOKS_REALM_ID": "<QUICKBOOKS_REALM_ID>",
"QUICKBOOKS_ENVIRONMENT": "<QUICKBOOKS_ENVIRONMENT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e QUICKBOOKS_CLIENT_ID=<QUICKBOOKS_CLIENT_ID> -e QUICKBOOKS_CLIENT_SECRET=<QUICKBOOKS_CLIENT_SECRET> -e QUICKBOOKS_REFRESH_TOKEN=<QUICKBOOKS_REFRESH_TOKEN> -e QUICKBOOKS_REALM_ID=<QUICKBOOKS_REALM_ID> -e QUICKBOOKS_ENVIRONMENT=<QUICKBOOKS_ENVIRONMENT> quickbooks npx -y @mindstone/mcp-server-quickbooksВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о QuickBooks Online
Как установить QuickBooks Online в Claude Code?
Выполните `claude mcp add mcp-server-quickbooks -e QUICKBOOKS_CLIENT_ID=<QUICKBOOKS_CLIENT_ID> -e QUICKBOOKS_CLIENT_SECRET=<QUICKBOOKS_CLIENT_SECRET> -e QUICKBOOKS_REFRESH_TOKEN=<QUICKBOOKS_REFRESH_TOKEN> -e QUICKBOOKS_REALM_ID=<QUICKBOOKS_REALM_ID> -- npx -y @mindstone/mcp-server-quickbooks`.
Что делает QuickBooks Online?
Сервер подключает Claude Code к QuickBooks Online через MCP. Агент может читать и менять счета, клиентов и поставщиков, выполнять запросы, запускать финансовые отчёты и скачивать счета в PDF.
Нужны ли для работы QuickBooks Online отдельные учётные данные?
Да. Для OAuth нужны QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, QUICKBOOKS_REFRESH_TOKEN, QUICKBOOKS_REALM_ID и QUICKBOOKS_ENVIRONMENT. Сервер также требует Node.js 20+ и npm.
