SSyncDev

Qb Time MCP Server

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

Local serverstdioPython

What is the Qb Time MCP Server?

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

Recorded tools

  • get_jobcodes — Get jobcodes with advanced filtering options
  • 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 — (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)
  • 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
  • get_jobcode_hierarchy — Get complete jobcode hierarchy structure

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_jobcodesGet jobcodes with advanced filtering options
ids(array of numbers) Filter by specific project IDs
active(string) Filter by status: "yes", "no", "both"
parent_ids(array of numbers, optional) Filter by parent jobcode IDs. Special values: 0 (top-level only), -1 (all levels)
customfields(boolean, optional) Include custom fields in response
modified_before(string) Filter by modification date (ISO 8601)
modified_since(string) Filter by modification date (ISO 8601)
page(number) Page number
limit(number) Results per page
get_jobcodeGet a specific jobcode by ID
id(number) The ID of the user to retrieve
get_jobcode_hierarchyGet complete jobcode hierarchy structure
Parameters:page: (number) Page number
get_timesheetsGet timesheets with filtering
start_date(string) Start date in YYYY-MM-DD format
end_date(string) End date in YYYY-MM-DD format
user_ids(array of numbers) Filter time entries by specific users
group_ids(array of numbers) Filter time entries by specific groups
jobcode_ids(array of numbers) Filter time entries by specific jobcodes
payroll_ids(array of strings, optional) Filter by payroll identification numbers
on_the_clock(string) Must be set to "yes"
jobcode_type(string) Filter by type: "regular", "pto", "unpaid_break", "paid_break", "all" (default: "all")
get_timesheetGet a specific timesheet by ID
get_current_timesheetsGet currently active timesheets
supplemental_data(string) Include supplemental data: "yes", "no" (default: "yes")
get_usersGet all users with filtering
not_ids(array of numbers, optional) Exclude specific user IDs
employee_numbers(array of numbers, optional) Filter by employee numbers
usernames(array of strings, optional) Filter by specific usernames
not_group_ids(array of numbers, optional) Exclude users from specific groups
first_name(string, optional) Filter by first name (supports wildcards )
last_name(string, optional) Filter by last name (supports wildcards )
TimeBased Filters:
Pagination:page: (number, optional) Page number (default: 1)
per_page(number) Results per page (default: 50, max: 50)
get_userGet a specific user by ID
get_current_userGet currently authenticated user
PermissionsCustom fields
get_groupsGet all groups from QuickBooks Time
manager_ids(array of numbers) Filter groups by manager user IDs
get_projectsGet projects with filtering
client_id(number) Filter by client ID
jobcode_id(number) Filter by associated jobcode ID
get_project_activitiesGet project activity logs
project_ids(array of numbers) Filter activities to specific projects
activity_types(array of strings) Filter by activity types: "status_change", "note_added", "budget_change", "date_change", "custom_field_change"
get_current_totalsGet current totals snapshot including shift and day totals
customfield_query(string) Filter by custom field values in format: | |
Returns:Project time totals
get_payrollGet payroll report
include_zero_time(boolean) Include jobcodes with no time entries (default: false)
get_payroll_by_jobcodeGet payroll report grouped by jobcode
get_project_reportGet detailed project report with time entries
customfielditems(object) Filter by custom field values in format: {"customfield_id": ["value1", "value2"]}
get_custom_fieldsGet custom tracking fields configured on timecards
applies_to(string) Filter by application type: "timesheet", "jobcode", "user"
value_type(string) Filter by value type: "managed-list", "free-form"
get_last_modifiedGet last modified timestamps for objects
get_notificationsGet notifications
get_managed_clientsGet managed clients

How to install the Qb Time MCP Server

{
  "mcpServers": {
    "qb-time-tools": {
      "command": "python",
      "args": [
        "./qb-time-mcp-server/main.py"
      ],
      "env": {
        "QB_TIME_ACCESS_TOKEN": "YOUR_QB_TIME_ACCESS_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
QB_TIME_ACCESS_TOKENDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Qb Time to get jobcodes.”
  • “Use Qb Time to ids.”
  • “Use Qb Time to name.”

Frequently asked questions

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 Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.