The QuickBooks MCP Server lets AI assistants access QuickBooks data via a standard interface. It uses the Model Context Protocol to expose QBO features as callable tools, enabling developers to build AI apps that fetch real-time QBO data through MCP.
接入配置
选择客户端,复制配置,再按项目文档补齐环境变量。
claude mcp add quickbooks-online --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>' -- node path/to/mcp-quickbooks-online/dist/index.js~/.codex/config.toml
[mcp_servers.quickbooks-online]
command = "node"
args = ["path/to/mcp-quickbooks-online/dist/index.js"]
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>" }
# codex mcp add quickbooks-online --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>' -- node path/to/mcp-quickbooks-online/dist/index.js~/.cursor/mcp.json
{
"mcpServers": {
"quickbooks-online": {
"command": "node",
"args": [
"path/to/mcp-quickbooks-online/dist/index.js"
],
"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>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"quickbooks-online": {
"type": "stdio",
"command": "node",
"args": [
"path/to/mcp-quickbooks-online/dist/index.js"
],
"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>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"quickbooks-online": {
"command": "node",
"args": [
"path/to/mcp-quickbooks-online/dist/index.js"
],
"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>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"quickbooks-online": {
"command": "node",
"args": [
"path/to/mcp-quickbooks-online/dist/index.js"
],
"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>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"quickbooks-online": {
"command": "node",
"args": [
"path/to/mcp-quickbooks-online/dist/index.js"
],
"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>"
}
}
}
}需要的环境变量
QUICKBOOKS_CLIENT_IDQUICKBOOKS_CLIENT_SECRETQUICKBOOKS_REFRESH_TOKENQUICKBOOKS_REALM_IDQUICKBOOKS_ENVIRONMENT
把占位值换成你自己的密钥;不要把密钥提交到代码仓库。