Skip to content
MCP server

Homebase MCP by usefulapi

Read Homebase locations, employees, shifts, timecards, labor costs and time clock status.

Install
Runs
Remotely
Version
1.27.0
Listing updated
4 days ago

About Homebase MCP by usefulapi

Homebase MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http homebase https://homebase.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://homebase.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "homebase": {
      "url": "https://homebase.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "homebase": {
      "type": "http",
      "url": "https://homebase.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "homebase": {
      "serverUrl": "https://homebase.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "homebase": {
      "type": "http",
      "url": "https://homebase.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (16)

Read directly from the server.

homebase_get_company
The Homebase company this API key belongs to: name, owner (id, name, email, phone) and created/updated times. GET /company.
homebase_list_locations
List the locations (stores or sites) of the account with uuid, name, address, phone, website and time zone. The uuid is the id every other Homebase tool needs. GET /locations.
homebase_get_location
One location by uuid: name, address, phone, website, time zone and POS merchant id. GET /locations/{location_uuid}.
homebase_get_location_plan
The Homebase subscription plan of a location: plan number, price, last update and trial state. GET /locations/{location_uuid}/plan.
homebase_list_employees
List the employees of a location with contact details and their job: level, default role, additional roles, wage type and rate, payroll id and archive date. The time-clock PIN is never returned. GET /locations/{location_uuid}/employees.
homebase_get_employee
One employee of a location by user id, with contact details and job (role, wage type and rate, payroll id). The id is the job's user id from homebase_list_employees. GET /locations/{location_uuid}/employees/{id}.
homebase_list_shifts
List the scheduled shifts of a location in a date range: employee, role, department, start and end, published/open state, wage rate and scheduled labor hours (regular, overtime). Filter open shifts only. GET /locations/{location_uuid}/shifts.
homebase_get_shift
One shift of a location by id, with its labor data and optional note. GET /locations/{location_uuid}/shifts/{id}.
homebase_list_deleted_shifts
The ids of shifts deleted in a date range at a location, with their start, end and deletion time. Use it to keep a copy of the schedule in sync. GET /locations/{location_uuid}/shifts/deleted.
homebase_list_timecards
List the timecards (worked time) of a location in a date range: employee, role, clock in and out, breaks, hours, labor cost, tips and approval state. Time-off hours are always 0 on timecards; use homebase_get_labor_by_employee for totals with time off. GET /locations/{location_uuid}/timecards.
homebase_get_timecard
One timecard of a location by id: clock in and out, breaks, labor hours and cost, tips, approval state. GET /locations/{location_uuid}/timecards/{id}.
homebase_list_deleted_timecards
The ids of timecards deleted in a date range at a location, with clock in, clock out and deletion time. Use it to keep a copy of the timecards in sync. GET /locations/{location_uuid}/timecards/deleted.
homebase_get_labor
Aggregate labor for a location in a date range, grouped by day or by hour: regular, overtime and paid hours, labor cost, tips, breaks and time off. GET /locations/{location_uuid}/labor.
homebase_get_labor_by_role
Aggregate labor (hours, cost, tips, overtime) for a location in a date range, grouped by role. GET /locations/{location_uuid}/labor/by_role.
homebase_get_labor_by_employee
Aggregate labor (hours, cost, wage rate, tips, overtime, time off) for a location in a date range, grouped by employee. Use it for payroll totals. GET /locations/{location_uuid}/labor/by_employee.
homebase_get_timeclock_status
The current time-clock state of one job (employee at a location): clocked_in, on_break or clocked_out, the current shift, the shifts that can be clocked into and the breaks that can be started. The job id is the `job.id` of an employee from homebase_list_employees. GET /timeclock/status.

Homebase MCP by usefulapi FAQ

How do I add Homebase MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http homebase https://homebase.usefulapi.io/mcp