# Homebase MCP for AI Agents AI Agent Connect > Homebase lets you manage your entire workforce directly through your AI client. You can handle employee scheduling, track clock-ins in real time, and oversee labor budgets across multiple locations. It turns your agent into a dedicated operations manager that knows exactly who is on the floor, what their shifts look like, and how your labor costs are stacking up. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_jID5HRgsceucoGZffTJIycSRFjXN0d671AVXIfq1/ai-agent-connect - **Tags:** employee-scheduling, time-tracking, shift-management, team-communication, workforce-management ## Description Homebase lets you manage your entire workforce directly through your AI client. You can handle employee scheduling, track clock-ins in real time, and oversee labor budgets across multiple locations. It turns your agent into a dedicated operations manager that knows exactly who is on the floor, what their shifts look like, and how your labor costs are stacking up. Managing a multi-site team usually means jumping between different tabs just to see who showed up for work or if the morning shift is fully staffed. It's a constant game of whack-a-mole with schedules and timecards. This Connector changes that by letting your agent do the heavy lifting for you. Instead of manually pulling reports, you can just ask your agent to check the current headcount at a specific store or see who's clocked in. It connects your Homebase account to your daily workflow, making it easy to keep an eye on labor budgets and department structures without the usual friction. You'll find it's one of the most practical ways to use the Vinkius catalog to keep your operations running smoothly. You can check employee profiles, pull up shift agendas for next week, and monitor timecards to ensure everyone is getting paid correctly. It basically gives your agent the eyes and ears it needs to act as a real coordinator for your staff. This means you spend less time on the admin side of things and more time actually running your business. ## Tools ### get_active_clock_ins See which employees are currently working at a specific site. This helps you monitor floor coverage in real time. ### get_employee_profile Get the full details for an individual staff member. This is useful for quickly pulling HR information. ### get_api_profile Check your current account status and plan details. Use this to see your own account information. ### list_departments See how a specific location is organized into different teams. This helps you understand the structure of a site. ### list_employees Get a full list of everyone working at a certain location. This makes it easy to see your total headcount. ### list_labor_budgets View the spending limits and configurations for your labor costs. Use this to keep your operations on budget. ### list_locations Find the unique IDs for all your different business sites. You need these IDs to use most of the other tools. ### list_defined_roles See the different job titles like Manager or Server at a location. This helps you see the specific roles available at a site. ### list_scheduled_shifts Look at the planned shifts and schedules for your team. This is great for checking upcoming coverage. ### list_timecards Pull the actual hours worked for a location to check against your goals. Use this to monitor your actual labor spend. ## Prompt Examples **Prompt:** ``` Who's working at the Downtown Cafe right now? ``` **Response:** ``` Checking active clock-ins for Downtown Cafe (hbc_102)... Currently, 4 employees are on-site: * **Alice Smith** (Barista) * **John Doe** (Manager) * **Michael Brown** * **Elena Rossi** Would you like to see their scheduled shift end times? ``` **Prompt:** ``` What's the schedule for next Wednesday? ``` **Response:** ``` Retrieving schedules for next Wednesday (April 14th) at your primary location: There are 6 shifts scheduled: * **Morning Prep** (06:00 AM) * **Mid-Day Shift** (10:00 AM) * **Closing Duty** (10:00 PM) Should I list the assigned employees for each shift? ``` **Prompt:** ``` Are we over our labor budget for the warehouse? ``` **Response:** ``` Checking labor budgets for the Warehouse location... **Current Status:** * **Labor Budget:** $1,200.00/day * **Actual Spend (Today):** $1,150.00 * **Status:** Under Budget Would you like to see the specific department breakdowns for today's spend? ``` ## Capabilities ### Check real-time clock-ins See exactly who is currently on the clock at any of your locations. ### Pull employee profiles Get detailed info on any staff member instantly. ### View shift schedules See what's planned for the coming days and who's assigned to what. ### Monitor labor budgets Keep track of your spending limits and labor configurations. ### List business locations Manage multiple sites by getting their unique identifiers quickly. ### Review timecards Check actual hours worked to keep your payroll data accurate. ## Use Cases ### Checking floor coverage during a rush A store manager asks who is currently on the clock at the cafe to see if they have enough coverage for a sudden rush of customers. ### Planning weekend staffing An operations lead asks for the shift schedule for next Wednesday to ensure all departments are properly staffed for the upcoming weekend. ### Verifying new hire details An HR specialist asks for the profile of a new hire to confirm their role and department assignment are correctly logged in the system. ### Auditing regional labor costs A regional manager asks to see the labor budgets for all locations to check for any spending overages across the company. ## Benefits - Get instant headcount updates with get_active_clock_ins so you know exactly who is on the floor without checking a separate dashboard. - Simplify payroll prep by using list_timecards to see exactly how many hours your team worked during the previous pay period. - Plan your week with more confidence using list_scheduled_shifts to see upcoming shift agendas and assigned staff. - Keep your spending in check by using list_labor_budgets to monitor your labor costs against your actual targets. - Speed up HR tasks by using get_employee_profile to pull detailed staff information whenever you need to update records. - Manage multiple sites more easily with list_locations to keep all your unique location IDs organized in one place. ## How It Works The bottom line is you get a hands-off way to manage workforce data through plain conversation. 1. Sign up for this Connector on the Vinkius Marketplace. 2. Add your Homebase API Key from your account settings. 3. Ask your agent to check shifts, headcount, or budgets. ## Frequently Asked Questions **How does Homebase MCP help with shift management?** It lets you ask your agent to pull up shift agendas and see who is assigned to what. You can check coverage for specific dates without digging through a web portal. **Can I check who is clocked in using Homebase MCP?** Yes, you can get a real-time list of employees currently on the clock at any of your locations. This is great for quick headcount checks during busy hours. **How do I track labor costs with Homebase MCP?** The Connector pulls your labor budget configurations directly. You can ask your agent to compare your current spending against your set limits for any location. **Can Homebase MCP see my employee profiles?** It can pull detailed information for specific employees. This makes it easy to find contact info, roles, or other profile details quickly. **Is Homebase MCP good for multi-location businesses?** It's ideal for multi-site operations. You can list all your business locations and then query specific data for each one using their unique identifiers. **Can I use Homebase MCP to check timecards?** Yes, you can retrieve timecard entries for a specific location. This helps you monitor actual hours worked to ensure your team's time is tracked correctly. **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.