MCP server

Homebase MCP by usefulapi

io.usefulapi/homebase

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

16

Token cost

About 3,651 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.homebase]
url = "https://homebase.usefulapi.io/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add homebase https://homebase.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"homebase","server_url":"https://homebase.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"homebase","server_url":"https://homebase.usefulapi.io/mcp"}

Tools

• homebase_get_company ~80 tokens
  The Homebase company this API key belongs to: name, owner (id, name, email, phone) and created/updated times. GET /company.
• homebase_get_employee ~222 tokens
  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_get_labor ~271 tokens
  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_employee ~245 tokens
  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_labor_by_role ~228 tokens
  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_location ~125 tokens
  One location by uuid: name, address, phone, website, time zone and POS merchant id. GET /locations/{location_uuid}.
• homebase_get_location_plan ~131 tokens
  The Homebase subscription plan of a location: plan number, price, last update and trial state. GET /locations/{location_uuid}/plan.
• homebase_get_shift ~179 tokens
  One shift of a location by id, with its labor data and optional note. GET /locations/{location_uuid}/shifts/{id}.
• homebase_get_timecard ~173 tokens
  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_get_timeclock_status ~174 tokens
  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_list_deleted_shifts ~320 tokens
  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_deleted_timecards ~324 tokens
  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_list_employees ~264 tokens
  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_list_locations ~95 tokens
  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_list_shifts ~424 tokens
  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_list_timecards ~396 tokens
  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.

Browse

• Email

Related MCP servers

• Papershift MCP by usefulapi
  Read Papershift absences, vacation, time tracking and shifts; request and review absences.
• Shiftbase MCP by usefulapi
  Read Shiftbase rosters, timesheets, absences and availability; schedule shifts and review absences.
• RotaCloud MCP by usefulapi
  Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and handle leave.
• Deputy MCP by usefulapi
  See rosters, timesheets, leave and staff in Deputy, and create shifts, leave and memos.
• Tamigo MCP by usefulapi
  Read Tamigo departments, employees, shifts, absences and opening hours; register attendance.
• When I Work MCP by usefulapi
  Check shifts, time clock entries, time-off requests, swaps and availability, and manage shifts.
• kiwiHR MCP by usefulapi
  Read kiwiHR employees, time off, timesheets, projects; create and update employees, timesheets.
• Breathe HR MCP by usefulapi
  Read Breathe HR employees, absences, sickness and leave; create and review leave requests.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/homebase.svg)](https://aptlynx.net/servers/io.usefulapi/homebase)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents