QuickBooks Time MCP Server (Combined)

What is QuickBooks Time MCP Server (Combined)?

QuickBooks Time MCP Server (Combined) is a single-interface MCP server that provides access to all QuickBooks Time API functionality. It combines tools for job codes, timesheets, users, reports, and project management into one server, intended for users who need to query and manage QuickBooks Time data through an AI assistant or terminal.

How to use QuickBooks Time MCP Server (Combined)?

Install dependencies with pip install -r requirements.txt, create a .env file with QB_TIME_ACCESS_TOKEN=your_token_here, then run python main.py. The server listens for JSON‑RPC requests on stdin/stdout and can be configured with Claude Desktop using the provided JSON snippet.

Key features of QuickBooks Time MCP Server (Combined)

• Single server covering all QuickBooks Time API endpoints
• Get job codes, timesheets, users, and groups with filtering
• Retrieve payroll and project reports by date range
• Supports pagination and custom field data
• Easy integration with Claude Desktop

Use cases of QuickBooks Time MCP Server (Combined)

• Querying current timesheets or active employees
• Generating payroll reports for a given date range
• Looking up job code hierarchies with filtering
• Retrieving project activities and custom fields
• Monitoring notifications and managed clients

FAQ from QuickBooks Time MCP Server (Combined)

What credentials do I need to run this server?

You need a QuickBooks Time access token, provided as QB_TIME_ACCESS_TOKEN in a .env file or in the Claude Desktop configuration.

How do I configure the server with Claude Desktop?

Add the provided JSON block to your Claude Desktop settings, replacing your_quickbooks_time_access_token_here with your actual token and adjusting the path to main.py.

What tools are available?

The server offers tools for job codes (get_jobcodes, get_jobcode, get_jobcode_hierarchy), timesheets (get_timesheets, get_timesheet, get_current_timesheets), users, groups, projects, project activities, reports (get_payroll, get_payroll_by_jobcode, get_project_report, get_current_totals), custom fields, last modified timestamps, notifications, and managed clients.

Is this project open source?

Yes, it is released under the MIT License.

How can I contribute or report issues?

Contributions are welcome via pull requests. Use the GitHub issues page to report bugs or request features.