Homebase MCP by usefulapi

io.usefulapiv1.0.0Updated Oct 10, 2026

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

VerifiedStreamable HTTPWeb executableData & AnalyticsProductivity & Workflow

Overview

AI-generated overview

Read-only access to Homebase company, location, employee, shift, timecard, labor and time clock data through a hosted MCP endpoint.

What it does
This hosted MCP server exposes Homebase workforce data to an assistant. Its read tools cover company and location details, location plans, employee lists and records, shifts (including deleted ones), timecards (including deleted ones), labor reports overall and broken down by role or employee, and current time clock status. A few meta tools report usage, request a feature, and manage a Pro subscription.
When to use it
Useful when an assistant needs to answer questions about staffing, schedules, hours worked, or labor cost from a Homebase account without opening the Homebase UI. Suited to managers or operations staff who want quick lookups and summaries of workforce data.
Requirements
A remote MCP client pointed at the hosted endpoint; no local install. Sign-in is by OAuth, and the login page asks for Homebase credentials. No API key or Authorization header should be added to the client config. Network access to the endpoint is required.
Before you install
The server asks for Homebase account credentials through its OAuth login page, so only connect if you trust the provider with that access. All listed data tools are read-only, but the meta tools can start a paid subscription, cancel it, or send a feature request. The free tier is limited to 100 tool calls per month; Pro is $9/month or $90/year per user, billed through a Stripe Checkout link, with no refund for the current period on cancellation.

Installation

In SourceWeft

  1. Open Homebase MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

README

Homebase MCP by usefulapi

Use Homebase from Claude, Cursor, or any MCP client — locations, employees, shifts, timecards, labor reports and time clock status. Hosted, no local install: connect with your own Homebase credentials.

Live endpoint: https://homebase.usefulapi.io/mcp · Homepage: https://usefulapi.io/homebase

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://homebase.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http homebase https://homebase.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "homebase": {      "url": "https://homebase.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Homebase credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/homebase/

Tools

ToolTypeWhat it does
homebase_get_companyreadGet company
homebase_list_locationsreadList locations
homebase_get_locationreadGet location
homebase_get_location_planreadGet location plan
homebase_list_employeesreadList employees
homebase_get_employeereadGet employee
homebase_list_shiftsreadList shifts
homebase_get_shiftreadGet shift
homebase_list_deleted_shiftsreadList deleted shifts
homebase_list_timecardsreadList timecards
homebase_get_timecardreadGet timecard
homebase_list_deleted_timecardsreadList deleted timecards
homebase_get_laborreadGet labor report
homebase_get_labor_by_rolereadGet labor report by role
homebase_get_labor_by_employeereadGet labor report by employee
homebase_get_timeclock_statusreadGet time clock status
homebase_usage_statusmetaUsage status (free-tier meter)
homebase_request_featuremetaRequest a missing feature
homebase_upgrademetaUpgrade to Pro (unlimited)
homebase_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited

Pro covers this server only. Subscribe with homebase_upgrade (it returns a Stripe Checkout link). Cancel any time with homebase_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running homebase_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Homebase.

Source: servers/homebase/README.md at commit 56eecbb

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 10, 2026