Homebase MCP. Manage shifts and track hours with conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Homebase. Automate scheduling, time tracking, and team management. Connect your AI agent directly to your employee data to check who's on site, view shifts, or verify hours worked.
Manage multi-site labor costs and team presence without leaving your chat window. It handles everything from listing all locations (`list_locations`) to getting real-time clock-ins (`get_active_clock_ins`).
What your AI agents can do
Get active clock ins
Lists all employees currently clocked in at a specified location.
Get api profile
Retrieves information about the authenticated user and their Homebase plan status.
Get employee profile
Gets detailed personal and professional information for a specific employee.
Instantly list every employee who is clocked in at a specific location.
List all business locations and retrieve the unique ID needed to query any other data.
Get a specific employee's full profile information.
Pull the upcoming shift schedule for employees at a given location.
Retrieve historical timecard entries (timesheets) for a location.
List all roles and departments configured across your business units.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Homebase MCP Server: 10 Tools for Workforce Management
Use these tools to manage every aspect of your team, from listing locations to retrieving real-time clock-ins and historical timecards.
019d75b2get active clock ins
Lists all employees currently clocked in at a specified location.
019d75b2get api profile
Retrieves information about the authenticated user and their Homebase plan status.
019d75b2get employee profile
Gets detailed personal and professional information for a specific employee.
019d75b2list defined roles
Lists every job role (like Manager or Server) set up for a particular location.
019d75b2list departments
Lists all departments configured for a specific location.
019d75b2list employees
Lists every employee assigned to a specific location.
019d75b2list labor budgets
Retrieves the financial labor budget configurations for a location.
019d75b2list locations
Lists all business locations connected to your Homebase account and provides their unique UUIDs.
019d75b2list scheduled shifts
Retrieves the planned shift schedules for employees at a specific location.
019d75b2list timecards
Lists historical timecard entries (timesheets) for a specific location.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Homebase, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Connect your AI agent to Homebase. You can manage scheduling, time tracking, and staff presence right from your chat window. It handles all the data retrieval, so you don't gotta mess with spreadsheets or jump between tabs. You'll get a complete picture of your workforce.
Get all site locationslist_locations lists every business location connected to your Homebase account, giving you the unique UUIDs you need to query all other data.
Check current staff presenceget_active_clock_ins lists every employee currently clocked in at a specific location.
Determine team structurelist_departments lists all departments configured for a specific location. list_defined_roles lists every job role, like Manager or Server, set up for a particular location.
Get employee detailslist_employees lists every employee assigned to a specific location. get_employee_profile pulls detailed personal and professional information for a specific employee.
List scheduled shiftslist_scheduled_shifts retrieves the planned shift schedules for employees at a specific location.
Track actual worked hourslist_timecards lists historical timecard entries (timesheets) for a specific location.
Manage budgetslist_labor_budgets retrieves the financial labor budget configurations for a location.
Check your plan statusget_api_profile retrieves information about the authenticated user and their Homebase plan status.
How Homebase MCP Works
- 1 Subscribe to the Homebase server and enter your Homebase API Key in the settings.
- 2 Start a conversation with your AI client (Claude, Cursor, etc.).
- 3 Ask your agent to perform a task, like 'Show me the timecards for Downtown Cafe last week.' The agent uses the correct tool, fetches the data, and presents the result.
The bottom line is: your agent uses the API key to pull specific, structured data from Homebase, so you don't have to log in or export anything.
Who Is Homebase MCP For?
Store Managers, Operations Leaders, and HR Specialists. If your job involves coordinating people across multiple sites or reconciling time sheets, this saves you hours of manual data crunching. You stop clicking through dashboards and start talking to your data.
Checks who is on site and what shifts are coming up without leaving the floor or switching apps.
Monitors labor costs and timecard compliance across multiple sites, checking budgets (list_labor_budgets) and historical data (list_timecards).
Automates gathering employee profiles (get_employee_profile) and department structures to validate staffing assignments.
What Changes When You Connect
- See who's on site right now. Use
get_active_clock_insto instantly check team presence at any location without leaving your chat window. - Cut down on manual payroll work. Run
list_timecardsto get all historical timesheet data for a location, eliminating manual exports. - Understand your full operation. Use
list_locationsfirst to get all site UUIDs, then run other tools against them for comprehensive oversight. - Stay on budget. Check labor costs by calling
list_labor_budgetsto ensure staffing levels don't exceed planned operational spending. - Streamline team setup. Use
list_defined_rolesandlist_departmentsto quickly map out your entire organizational structure. - Get employee details on demand. Run
get_employee_profileto pull a specific person's full record, useful for HR or compliance checks.
Real-World Use Cases
Investigating a sudden staffing shortage
A store manager needs to know who is working right now. They ask their agent, 'Who's clocked in at the Airport Kiosk?' The agent runs get_active_clock_ins, providing a list of currently working staff and their roles, allowing the manager to call for backup immediately.
Auditing payroll compliance
HR needs to check a full month's worth of hours for a specific site. They prompt their agent to run list_timecards for the 'Main Warehouse' last month. The agent fetches all records, making it simple to verify compliance and total hours worked.
Planning for a new season launch
The ops leader needs to know what staff are available and what the budget allows. They first use list_locations to confirm all sites, then run list_labor_budgets and list_scheduled_shifts to plan staffing without overspending.
Updating a team member's record
The HR specialist needs to update records for an employee who changed departments. They use get_employee_profile to pull the current data and list_departments to confirm the correct structure before making changes.
The Tradeoffs
Manual data cross-referencing
Exporting a list of employees from one tab, copying UUIDs into a spreadsheet, and then using those UUIDs to manually check schedules in another tool.
→
First, use list_locations to get the necessary location UUID. Then, feed that UUID into list_employees and list_scheduled_shifts. Your agent handles the cross-referencing instantly.
Assuming real-time data availability
Checking who is working right now, but the data is only available via end-of-day batch exports, leading to inaccurate reports.
→
Use get_active_clock_ins to get real-time data. This tool shows who is physically clocked in at the exact moment you ask.
Ignoring location scope
Running a general report on timecards that includes data from every site, making it impossible to isolate the specific branch needing attention.
→
Always use list_locations first to get the specific location UUID, then run list_timecards using that UUID. This scopes the data correctly.
When It Fits, When It Doesn't
Use this server if your job is fundamentally about workforce coordination: tracking who is where, when they worked, and how much it costs. You need to correlate location data, employee profiles, and time entries into a single conversational output. Don't use it if you only need to view a static document (like a PDF payroll summary) or if your primary need is financial forecasting outside of labor budgets. If you only need to check if an employee exists, get_employee_profile is enough, but if you need to know their shifts, you need the full suite of tools.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Homebase. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Juggling location IDs and spreadsheets is a waste of time.
Right now, checking site status means jumping between the main dashboard, downloading a list of locations, manually copying the UUIDs, and then pasting those IDs into three different tabs (schedules, employees, timecards). It’s slow, and you always risk grabbing the wrong ID.
With the Homebase MCP Server, you ask your agent, 'List all business locations.' You get the full list and all UUIDs instantly. Then you ask, 'What's the schedule for that UUID?' The whole process happens in chat, giving you the data you need without the spreadsheet mess.
Homebase MCP Server: Check who's clocked in right now.
Before, checking live presence meant logging into the system and looking at a live dashboard widget. If the dashboard lagged or timed out, you had no data. You were limited by the UI's performance.
Now, you just ask. Your agent runs `get_active_clock_ins` and reports the live status immediately. It's direct, specific, and faster than any dashboard refresh.
Common Questions About Homebase MCP
How do I obtain my Homebase API Key? +
Log in to Homebase as an Owner, ensure you are on the 'All in One' plan, navigate to Settings > API Access, and click Request API Key. Your key will typically be approved within one business day.
Is the Homebase API read-only? +
Yes, as of current documentation, the Homebase public API provides read-only access to locations, employees, timecards, and schedules. Writing data (like creating shifts) must be done through the web dashboard or official POS/Payroll integrations.
How can I see who is currently working? +
Use the get_active_clock_ins tool with your location UUID. It filters current timecards to show only employees who have clocked in but not yet clocked out for the day.
Is the integration secure for managing employee data? +
Absolutely. The integration uses official Homebase Bearer tokens over HTTPS. Your credentials and sensitive employee information are encrypted and stored securely within the Vinkius Cloud infrastructure.
How do I use the `list_locations` tool to find a site's UUID? +
You run list_locations first to get a full list of UUIDs. Then, you pass the desired UUID to other tools like list_employees or list_scheduled_shifts to target the correct site.
What if I need to check multiple locations for active staff? Does Homebase support batch checks? +
You need to run list_locations to get all site UUIDs. Your agent can then loop through those UUIDs and call get_active_clock_ins for each one, giving you a comprehensive status report.
Can the Homebase server track labor costs and department structure? Which tools handle this? +
Yes. Use list_labor_budgets to check cost limits, and list_departments combined with list_defined_roles to map out your team's structure.
If I need to see a specific employee's full history, should I use `get_employee_profile` or `list_timecards`? +
get_employee_profile gives you current details like roles and contact info. For a full work history, you must use list_timecards to pull all past time entries for that location.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
NameSilo (Domain Registrar Developer API)
Manage your domain portfolio, DNS records, and registrations directly through NameSilo's developer API.
Deterministic Readability Scorer
Equip your AI with strict linguistic math. Calculate Flesch-Kincaid, Gunning Fog indexes, and exact reading times deterministically.
CEO Strategy Prover
AI agents think like consultants, not CEOs. This tool forces platform-level strategy: map the ecosystem, ground moves in real competitive precedents, identify defensible moats, define metric-driven execution, and validate market reality. Think Bezos, not backlog.
You might also like
CNJ (Datajud API Pública)
Access the Brazilian National Council of Justice (CNJ) Datajud API to query judicial processes, procedural classes, and court organs across Brazil.
N-Gram Frequency Engine
Exact deterministic unigram, bigram, and trigram counting over huge texts. Save tokens and guarantee 100% accurate phrase counts.
Clerk
Add production-ready authentication to your app with user management, SSO, multi-factor auth, and session handling out of the box.