Overview
QuickBooks Time MCP Server is a combined server that provides a unified interface for accessing all QuickBooks Time API functionalities, integrating features from multiple servers into one.
To use the server, install the necessary dependencies, set up an environment file with your QuickBooks Time access token, and run the server using the command python main.py. Additionally, configure it for use with Claude Desktop according to the provided example settings.
- Integration of four separate servers for streamlined access to the QuickBooks Time API - Multiple tools for managing job codes, timesheets, user data, and projects - Ability to generate detailed reports from the database as needed
- Managing employee timesheets efficiently using the Timesheet Tools.
- Retrieving job code hierarchies and managing job code data.
- Generating payroll and project reports for financial tracking.
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": {
"aallsbury-qb-time-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aallsbury-qb-time-mcp-server-mcp-mirror"
]
}
}
}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": {
"aallsbury-qb-time-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aallsbury-qb-time-mcp-server-mcp-mirror"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"aallsbury-qb-time-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aallsbury-qb-time-mcp-server-mcp-mirror"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"aallsbury-qb-time-mcp-server-mcp-mirror": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aallsbury-qb-time-mcp-server-mcp-mirror"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"aallsbury-qb-time-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aallsbury-qb-time-mcp-server-mcp-mirror"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"aallsbury-qb-time-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aallsbury-qb-time-mcp-server-mcp-mirror"
]
}
}
}FAQ
What dependencies are required to run the server?
You need to install the dependencies listed in `requirements.txt` using `pip install -r requirements.txt`.
Can I contribute to the development of this project?
Yes, contributions are welcome! You can submit a Pull Request or provide feedback through GitHub.
Is there a license for this project?
Yes, it operates under the MIT License, and you can find the details in the LICENSE file.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":516,"uuid":"8a6ea73e-3a3c-4dba-8fd6-695f91a79f12","name":"aallsbury_qb-time-mcp-server","title":"QuickBooks Time MCP Server (Combined)","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2024-12-30T02:52:53.738Z","updated_at":"2025-01-05T03:00:17.682Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"quickbooks,mcp-server,api-tools","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/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"}]]}]