QuickBooks Online MCP Server
A community-built Model Context Protocol server for QuickBooks Online that exposes 18 tools for managing invoices, customers, and payments. It implements a real OAuth 2.1 authorization-code + PKCE flow with automatic token refresh, client-side rate limiting, and structured error mapping. The server runs over stdio and Streamable HTTP transports, allowing AI agents to create, read, update, and delete customer and payment records while adhering to QuickBooks API throttles.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Create, read, update, and delete customer records in QuickBooks Online
- Manage invoices including creation, listing, and searching
- Process and track payments within the QuickBooks ecosystem
- Retrieve company and receivables resources via read-only endpoints
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
mcp-quickbooks 0.1.0
{
"version": "0.1.0",
"transport": "stdio",
"identifier": "mcp-quickbooks",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"runtimeArguments": [
{
"type": "positional",
"value": "stdio",
"isRequired": true,
"description": "Run the server over stdio."
}
],
"environmentVariables": [
{
"name": "QBO_CLIENT_ID",
"isRequired": true,
"description": "Intuit app client id."
},
{
"name": "QBO_CLIENT_SECRET",
"isRequired": true,
"description": "Intuit app client secret."
},
{
"name": "QBO_ENVIRONMENT",
"default": "sandbox",
"description": "sandbox or production."
},
{
"name": "QBO_REALM_ID",
"description": "QuickBooks company (realm) id."
},
{
"name": "QBO_SCOPES",
"default": "com.intuit.quickbooks.accounting",
"description": "Space-separated OAuth scopes; defaults to accounting only."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"quickbooks-online-mcp-server": {
"command": "uvx",
"args": [
"mcp-quickbooks==0.1.0"
],
"env": {
"QBO_CLIENT_ID": "<YOUR_QBO_CLIENT_ID>",
"QBO_CLIENT_SECRET": "<YOUR_QBO_CLIENT_SECRET>",
"QBO_ENVIRONMENT": "<YOUR_QBO_ENVIRONMENT>",
"QBO_REALM_ID": "<YOUR_QBO_REALM_ID>",
"QBO_SCOPES": "<YOUR_QBO_SCOPES>"
}
}
}
}Cline
{
"mcpServers": {
"quickbooks-online-mcp-server": {
"command": "uvx",
"args": [
"mcp-quickbooks==0.1.0"
],
"env": {
"QBO_CLIENT_ID": "<YOUR_QBO_CLIENT_ID>",
"QBO_CLIENT_SECRET": "<YOUR_QBO_CLIENT_SECRET>",
"QBO_ENVIRONMENT": "<YOUR_QBO_ENVIRONMENT>",
"QBO_REALM_ID": "<YOUR_QBO_REALM_ID>",
"QBO_SCOPES": "<YOUR_QBO_SCOPES>"
}
}
}
}VS Code
{
"servers": {
"quickbooks-online-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-quickbooks==0.1.0"
],
"env": {
"QBO_CLIENT_ID": "<YOUR_QBO_CLIENT_ID>",
"QBO_CLIENT_SECRET": "<YOUR_QBO_CLIENT_SECRET>",
"QBO_ENVIRONMENT": "<YOUR_QBO_ENVIRONMENT>",
"QBO_REALM_ID": "<YOUR_QBO_REALM_ID>",
"QBO_SCOPES": "<YOUR_QBO_SCOPES>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"quickbooks-online-mcp-server": {
"command": "uvx",
"args": [
"mcp-quickbooks==0.1.0"
],
"env": {
"QBO_CLIENT_ID": "<YOUR_QBO_CLIENT_ID>",
"QBO_CLIENT_SECRET": "<YOUR_QBO_CLIENT_SECRET>",
"QBO_ENVIRONMENT": "<YOUR_QBO_ENVIRONMENT>",
"QBO_REALM_ID": "<YOUR_QBO_REALM_ID>",
"QBO_SCOPES": "<YOUR_QBO_SCOPES>"
}
}
}
}Let your agent find its tools
Find servers like QuickBooks Online MCP Server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.