# 7shifts MCP MCP > 7shifts MCP connects your restaurant workforce management account to any AI agent. It lets you handle everything from scheduling shifts and adding new employees to tracking time clock entries, all through natural conversation. Coordinate staff assignments, manage labor costs, and get a full picture of operations without leaving your chat window. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** staff-scheduling, labor-cost-tracking, workforce-management, restaurant-ops, employee-management ## Description Forget jumping between the 7shifts dashboard and your calendar just to figure out who is working where. This MCP connects your workforce management data directly into your agent, letting you coordinate everything about your team using simple language. Need to see who's on shift next week? Just ask. Need to add a new manager profile or check if someone punched in late? It handles it. You get instant visibility into staff lists, active work assignments, and actual time punches—all pulled directly from the source of truth. Because you run your business off data, connecting this MCP through Vinkius means all your workforce metrics are available to any compatible agent. This gives you a single place to manage everything from employee onboarding to daily labor compliance. ## Tools ### create_employee Adds a brand new employee profile to your system. ### create_shift Schedules and creates a new work assignment for staff. ### get_account_info Retrieves basic information about your connected account profile. ### get_employee Pulls specific, detailed data on a single staff member's record. ### list_departments Lists all the distinct departments within your restaurant group. ### list_employees Generates a complete list of every employee in your system. ### list_locations Shows all the physical business locations you manage. ### list_roles Retrieves a catalog of available job roles used by your staff. ### list_schedules Lists all past and future work schedules for review. ### list_shifts Provides a comprehensive list of all scheduled shifts. ### list_time_punches Retrieves historical records of when employees clocked in and out. ### list_webhooks Displays all active webhooks set up for real-time event monitoring. ## Prompt Examples **Prompt:** ``` List all employees in my 7shifts account. ``` **Response:** ``` I've retrieved your employee list. You have 15 active staff members including 'Alex Rivera', 'Sarah Chen', and 'Mike Ross'. Which one would you like to see the shifts for? ``` **Prompt:** ``` Show me the shifts for 'Alex Rivera' (ID: user_10293). ``` **Response:** ``` I've fetched the shifts for Alex. He has 3 assignments this week: Tuesday (10:00 - 18:00), Thursday (12:00 - 20:00), and Saturday (08:00 - 16:00). All are scheduled at the 'Downtown' location. ``` **Prompt:** ``` Create a new shift at location 'loc_8823' for tomorrow from 09:00 to 17:00. ``` **Response:** ``` Success! A new work assignment has been created for tomorrow (09:00 - 17:00) at the Downtown unit. It is currently unassigned. Would you like me to assign an employee to it? ``` ## Capabilities ### Manage Employee Records Create new staff profiles and pull detailed information on existing team members. ### Coordinate Work Assignments Build, view, and track shifts across different departments and store locations. ### Monitor Labor Compliance Review actual time clock entries to verify who clocked in and out. ### Understand Business Structure Retrieve metadata about your company's locations, departments, and employee roles. ## Use Cases ### Staffing for a Holiday Rush A manager needs to know if every location is covered next weekend. They ask their agent, 'Show me all shifts for the North and South locations next Saturday.' The agent uses `list_shifts` to give them an instant report card. ### Payroll Audit After Incident A payroll coordinator suspects a time entry error. They prompt the agent, 'Pull all time punches for Mike Ross from last Friday.' The agent uses `list_time_punches` to provide the exact clock-in/out data needed for an audit. ### Adding a New Manager The owner needs to add a new department manager. They simply ask, 'Add Sarah Chen as a Department Head.' The agent uses `create_employee` and handles the entire record creation process. ### Weekly Planning Review An operations team member reviews upcoming staffing needs by asking, 'What are all scheduled shifts for next week?' The agent runs through `list_schedules` to give a complete overview of labor planning. ## Benefits - Stop guessing staffing levels. You can ask the agent to pull all active shifts using `list_shifts` and instantly see your coverage gaps across departments. - Simplify employee onboarding. Instead of filling out forms, you can use `create_employee` through natural conversation, saving time on paperwork and record keeping. - Verify labor compliance immediately. Running `list_time_punches` lets you check clock-in/out times for any date range with one prompt—no more digging through spreadsheets. - Keep your structure clear. You can use tools like `list_departments` or `list_locations` to understand the full scope of your organization's setup at a glance. - Automate scheduling changes. Use `create_shift` when an employee calls out, and the agent handles the assignment and update process without you needing to touch the web portal. ## How It Works The bottom line is you control complex scheduling tasks using natural conversation instead of clicking through multiple web pages. 1. Subscribe to this MCP and provide your 7shifts Company GUID and Token. 2. Connect your preferred AI client (like Cursor or Claude) via Vinkius. 3. Ask the agent a question—for example, 'What shifts are scheduled for next Tuesday?'—and get instant answers. ## Frequently Asked Questions **How do I create a new shift using the `create_shift` tool?** You ask your agent to 'Create a new shift for Mike tomorrow from 10 am to 6 pm.' The agent handles formatting and calls the necessary API endpoint, leaving you with an immediate success message. **What is the difference between `list_shifts` and `list_schedules`?** `list_shifts` gives a list of specific work assignments. Use `list_schedules` if you need to see the broader, overarching weekly planning calendar. **Can I get employee details using the `get_employee` tool?** Yes. If you know an employee's name or ID, asking the agent to retrieve their profile gives you all their metadata in one go without navigating menus. **Do I need to use a specific token for `list_time_punches`?** Yes. The MCP requires your company GUID and Token during setup so the agent has permission to pull sensitive time clock data securely. **How do I check which webhooks are currently active using the `list_webhooks` tool?** The `list_webhooks` tool shows all configured webhooks for your account. This lets you verify real-time event monitoring, ensuring that changes like new shifts or time punches trigger automated actions in other systems. **If I only know the store name, how can I get a list of business locations using the `list_locations` tool?** The `list_locations` tool returns every active business location and its unique ID. You use this data to filter down to specific stores or departments when running other queries like shift checks. **What should I do if the `create_employee` tool fails because of missing information?** If creation fails, check your request against required parameters. You must provide necessary details—like department IDs or role assignments—to ensure the profile is fully functional in the system. **Where can I check general account settings using the `get_account_info` tool?** This MCP call provides a snapshot of your overall account details. It's useful for confirming credentials, checking service status, or validating basic organizational setup before running complex reports. **Can I see all the active shifts for a specific employee via AI?** Yes! Use the `list_shifts` tool and provide the optional `user_id`. Your agent will retrieve the complete work history and future assignments for that specific person. **How do I create a new work shift using the agent?** Use the `create_shift` action. You'll need to provide the Location ID, and the start and end times in ISO 8601 format (e.g., 2024-12-01T10:00:00Z). **Is it possible to check real-time clock-in data via AI?** Absolutely. Use the `list_time_punches` query. The agent will retrieve the history of actual clock-in and clock-out events, allowing you to verify labor compliance instantly.