QuickBooks Time MCP Server (V2 Update)

This is a combined MCP server that provides access to all QuickBooks Time API functionality through a single interface. It combines the functionality of four separate servers:

1. JobCode Tools
2. Reports & Core Tools
3. Timesheet Tools
4. User Tools

I would LOVE help improving this project! Just glad to be able to give something back finally!

This entire project was developed and published using artificial intelligence (Anthropic, OpenAI, Llama/META), as I personally cannot write much code without assistance. While every effort has been made to ensure quality and functionality, there may be imperfections or areas for improvement. I welcome any feedback, corrections, or suggestions from the community.

1. Install dependencies:

pip install -r requirements.txt

2. Create a .env file with your QuickBooks Time access token:

QB_TIME_ACCESS_TOKEN=your_access_token_here
NODE_ENV=development

Claude Desktop Configuration

To use this server with Claude Desktop, you’ll need to configure it in your Claude Desktop settings. Here’s an example configuration:

{
  "globalShortcut": "Ctrl+Q",
  "mcpServers": {
    "qb-time-tools": {
      "command": "python",
      "args": [
        "./qb-time-mcp-server/main.py"
      ],
      "env": {
        "QB_TIME_ACCESS_TOKEN": "your_quickbooks_time_access_token_here"
      }
    }
  }
}

Available Tools

JobCode Tools

• get_jobcodes: Get jobcodes with advanced filtering options

  • Basic Filters:
    • ids: (array of numbers, optional) Comma separated list of jobcode IDs
    • name: (string, optional) Filter by jobcode name, supports wildcard (*) matching from string start
    • active: (string, optional) Filter by status: “yes”, “no”, “both” (default: “yes”)
  • Type and Hierarchy Filters:
    • type: (string, optional) Filter by type: “regular”, “pto”, “paid_break”, “unpaid_break”, “all” (default: “regular”)
    • parent_ids: (array of numbers, optional) Filter by parent jobcode IDs. Special values: 0 (top-level only), -1 (all levels)
  • Additional Filters:
    • customfields: (boolean, optional) Include custom fields in response
    • modified_before: (string, optional) Filter by modification date (ISO 8601 format)
    • modified_since: (string, optional) Filter by modification date (ISO 8601 format)
    • page: (number) Page number for pagination
    • limit: (number) Results per page (max 200)

• get_jobcode: Get a specific jobcode by ID

  • Required Parameters:
    • id: (number) The ID of the jobcode to retrieve

• get_jobcode_hierarchy: Get complete jobcode hierarchy structure

  • Parameters:
    • parent_ids: (array of numbers, optional) Filter by parent IDs. Values: 0 (top-level), -1 (all), or specific IDs
    • active: (string, optional) Filter by status: “yes”, “no”, “both” (default: “yes”)