drio
Open app

QuickBooks Time MCP Server (Combined)

Source

A Message Control Protocol (MCP) server that provides unified access to QuickBooks Time API functionality. Developed with AI assistance.

Catalog onlyCatalog onlySTDIO

Overview

QuickBooks Time MCP Server is a Message Control Protocol (MCP) server that provides unified access to all QuickBooks Time API functionalities through a single interface, combining the features of multiple servers into one.

To use the server, install the required dependencies, create a .env file with your QuickBooks Time access token, and run the server using Python. Configuration is also needed for integration with Claude Desktop.

  • Unified access to QuickBooks Time API functionalities - Support for JobCode, Timesheet, User, and Project Management tools - Ability to filter and retrieve specific data through various API endpoints
  1. Managing job codes and timesheets efficiently.
  2. Generating payroll reports based on job codes and time entries.
  3. Accessing user and project management data seamlessly.

Add to your AI client

Use these steps to connect QuickBooks Time MCP Server (Combined) in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "qb-time-mcp-server-aallsbury": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-qb-time-mcp-server-aallsbury"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "qb-time-mcp-server-aallsbury": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-qb-time-mcp-server-aallsbury"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "qb-time-mcp-server-aallsbury": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-qb-time-mcp-server-aallsbury"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "qb-time-mcp-server-aallsbury": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-qb-time-mcp-server-aallsbury"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "qb-time-mcp-server-aallsbury": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-qb-time-mcp-server-aallsbury"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "qb-time-mcp-server-aallsbury": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-qb-time-mcp-server-aallsbury"
      ]
    }
  }
}

FAQ

What is the purpose of this server?

It provides a single interface to access all QuickBooks Time API functionalities, simplifying integration and usage.

How do I contribute to the project?

Contributions are welcome! You can submit a Pull Request on GitHub.

Is there support available for issues?

Yes, you can report issues or feature requests on the GitHub issues page.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":770,"uuid":"c0abe718-9a1b-463d-8407-21b88e6534df","name":"qb-time-mcp-server","title":"QuickBooks Time MCP Server (Combined)","description":"A Message Control Protocol (MCP) server that provides unified access to QuickBooks Time API functionality. Developed with AI assistance.","avatar_url":"https://avatars.githubusercontent.com/u/57548804?v=4","created_at":"2024-12-30T03:30:47.940Z","updated_at":"2025-02-23T07:16:02.766Z","status":"created","author_name":"aallsbury","author_avatar_url":"https://avatars.githubusercontent.com/u/57548804?v=4","tags":"quickbooks,mcp-server,api-access","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/aallsbury/qb-time-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools