# Homebase Muse connector

From musedirectory.ai, the independent directory of Meta Muse connectors. Not affiliated with Meta.

## Homebase

Access employee schedules, timecards, labor costs and time clock status for your Homebase locations.

- Record: https://musedirectory.ai/connector/homebase
- Category: Productivity
- Developer: usefulapi (https://usefulapi.io/homebase/)
- Muse status: Extra setup. Not in Muse's Connectors list yet. Muse can still use it: its page gives you a request to paste into Muse.
- Health: Working, 1054ms, checked 2026-10-29T11:16:06Z
- Endpoint: https://homebase.usefulapi.io/mcp
- Auth: No account needed; Pricing: unknown
- Screening: Screened, no issues found (2026-10-29T12:36:05Z)
- Source: Found in the official MCP Registry (io.usefulapi/homebase) https://registry.modelcontextprotocol.io/v0/servers?search=io.usefulapi%2Fhomebase

Read Homebase locations, employees, shifts, timecards, labor costs and time clock status. Query schedules, worked hours, labor expenses, tips and payroll data by location, employee or role. Track deleted shifts and timecards for sync.

Example request: "Show me the total labor cost and hours for each employee this week so I can review payroll."

How to connect: Not in Muse's Connectors list yet, but Muse can still use it. Paste this into Muse: "Use Homebase to help me. It is a free service with an MCP server at https://homebase.usefulapi.io/mcp. It does not need an API key. Ask me before you share anything with it." Muse asks before it shares anything with the app's site. Meta does not review apps used this way, so only use ones you trust. We tested this in the Muse app on September 24, 2026: Muse used an app's link directly this way and returned a live answer.

Tools:
- 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_uu
- 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

Screening checks:
- MCP handshake: pass (Answered in 1089ms)
- Domain against threat feeds (Cloudflare security DNS): pass (homebase.usefulapi.io, usefulapi.io not flagged)
- Published packages against the OSV malicious-package database: n/a (No npm or PyPI package published)
- Hidden instructions or invisible characters in tool text: pass (16 tools read, nothing found)
- Inputs asking for passwords, card numbers or seed phrases: pass (None found)
- Domain and redirects: pass (No redirects off the domain)
- AI review of purpose and tool behavior: pass (No concerns)