# Homebase MCP > Homebase MCP connects your AI agent directly to your employee scheduling and time tracking system. Manage shifts, check team attendance, and review payroll data—all through natural conversation. You can list all company locations, check who's currently clocked in at any site, or pull full timecard entries for compliance checks. Stop exporting CSV files; just ask your AI client. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** employee-scheduling, time-tracking, shift-management, team-communication, workforce-management ## Description You connect this MCP to bring real-time workforce management into your daily workflow. Instead of juggling multiple dashboards and spreadsheets, you can simply talk to your agent about your team's availability. You’ll get instant lists of all business locations first, which then lets you pull employee rosters or check out the current schedule for any site. Need to know who's on the floor right now? Just ask, and your agent checks active clock-ins. Need to plan next week? It pulls upcoming shifts and can even monitor labor budgets across departments. This level of operational detail makes scheduling complex tasks simple—you don't have to manually pull timecards for every employee just to verify hours worked. By connecting Homebase via Vinkius, you get a single source of truth for your team’s movements and schedules right where you work. ## Tools ### get_active_clock_ins Lists every employee currently clocked into a specific company location. ### get_employee_profile Provides detailed personal and professional information for an individual staff member. ### get_api_profile Displays the API connection status and details about the account owner's subscription plan. ### list_departments Lists all official departments that have been set up for a specific business site. ### list_employees Presents a roster of every employee associated with a particular location. ### list_labor_budgets Retrieves the financial configurations for labor budgets set up at various locations. ### list_locations Finds and lists all business addresses associated with your Homebase account, providing their unique UUID. ### list_defined_roles Lists the different job titles or roles (like 'Manager' or 'Cashier') configured for a site. ### list_scheduled_shifts Gets an upcoming schedule listing of shifts assigned to employees at any given location. ### list_timecards Retrieves detailed timecard entries, useful for verifying the actual clock-in and clock-out times worked. ## Prompt Examples **Prompt:** ``` List all business locations and find the UUID for 'Downtown Cafe'. ``` **Response:** ``` I've retrieved your locations. You have 3 sites: 'Downtown Cafe' (UUID: hbc_102), 'Airport Kiosk' (UUID: hbc_105), and 'Main Warehouse'. Which location's schedule would you like to check? ``` **Prompt:** ``` Who is currently clocked in at the Downtown Cafe? ``` **Response:** ``` Checking active clock-ins for Downtown Cafe (hbc_102)... Currently, 4 employees are on-site: 'Alice Smith' (Barista), 'John Doe' (Manager), 'Michael Brown', and 'Elena Rossi'. Would you like to see their scheduled shift end times? ``` **Prompt:** ``` Show the scheduled shifts for next Wednesday. ``` **Response:** ``` Retrieving schedules... For next Wednesday (April 14th) at your primary location, 6 shifts are scheduled, starting with 'Morning Prep' at 06:00 AM and ending with 'Closing Duty' at 10:00 PM. Should I list the assigned employees for each shift? ``` ## Capabilities ### Check real-time site presence Instantly see which employees are currently clocked in at any specific location. ### Manage team structure data List all departments and defined roles within your company to understand the current organizational setup. ### Review employee details Pull detailed profile information for any specific staff member on file. ### View scheduled shifts Get a list of upcoming shift agendas and schedules for your team at various sites. ### Track hours worked Monitor actual time worked by pulling historical records and detailed timecard entries. ### Analyze operational costs Retrieve configured labor budgets to ensure staffing remains aligned with company spending limits. ## Use Cases ### Need to know who is available for a last-minute shift? A manager needs to cover two unexpected call-outs. They ask their agent, 'Who is scheduled for the Downtown Cafe next week?' The agent uses `list_scheduled_shifts` and lists all open slots, letting the manager assign coverage instantly. ### Audit payroll hours across multiple sites. An operations leader must verify total paid hours for Q2. They prompt their agent to check timecards across three locations using `list_timecards`, getting a consolidated view of all clock-in/out data without logging into three separate portals. ### Onboarding a new department. The HR specialist needs to know what job titles exist. They ask the agent, and it uses `list_defined_roles` to provide a list of all official roles (e.g., 'Barista', 'Manager') used across the network. ### Check daily team readiness before opening. The shift supervisor needs to confirm coverage for the day's prep work. They ask, and the agent runs `list_locations` first to confirm the site UUID, then uses that ID to check all active employees using `get_active_clock_ins`. ## Benefits - Get instant site status checks. Instead of calling `get_active_clock_ins`, your agent tells you exactly who is on the floor right now, saving time during busy operational periods. - Simplify complex payroll audits. Use `list_timecards` to pull specific timesheets without exporting files, giving you immediate verification of total hours worked for compliance. - Maintain perfect visibility into staffing limits. By checking `list_labor_budgets`, you can ensure the team's planned shifts don't exceed operational spending caps before they happen. - Stop guessing who works where. You can pull a full employee roster using `list_employees` and then check their specific profile details with `get_employee_profile` for necessary context. - Future-proof your workflow. When connected through Vinkius, you get access to all these scheduling tools in one place, eliminating the need to switch between dedicated HR dashboards. ## How It Works The bottom line is you manage complex staffing tasks using conversation instead of clicking through multiple web interfaces. 1. Subscribe to this MCP and enter your Homebase API Key in the Vinkius platform settings. 2. Your AI client authenticates, giving the agent permission to access your employee scheduling data. 3. You prompt your agent with natural language questions (e.g., 'Who is clocked in at the Main Warehouse?') and receive immediate, accurate answers. ## Frequently Asked Questions **How do I find the location UUID for my store using Homebase MCP?** You use the `list_locations` tool. This action retrieves all business locations associated with your account, and crucially, it provides the unique 'location_uuid' you need to run any other scheduling or timecard tools. **Can I check who is clocked in using Homebase MCP?** Yes, use `get_active_clock_ins`. This tool checks your specified location and gives a real-time list of every employee currently on site. **Does Homebase MCP help with payroll reports?** While it doesn't process payroll, you can pull the raw data needed for reporting. Specifically, `list_timecards` lets you retrieve detailed timecard entries to calculate total hours worked. **How many tools are available in Homebase MCP?** This MCP provides access to ten distinct tools that cover everything from listing departments to checking active clock-ins, giving deep coverage of your operational needs. **What is the difference between `list_employees` and `get_employee_profile` using Homebase MCP?** `list_employees` gives you a simple list (a roster) of every staff member at one site. You use `get_employee_profile` when you need deep, specific details about just one person.