# ClockShark MCP MCP > ClockShark lets you manage field crew time, job costs, and scheduling using GPS-verified timesheets. It connects your operations directly to natural conversation, letting your AI agent automate payroll reporting, assign shifts, and track project spending so you can keep construction teams on budget. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-tracking, gps-tracking, timesheets, job-costing, shift-scheduling, workforce-management ## Description Stop the headache of chasing down manual paperwork or digging through complex spreadsheets just to know how much labor costs are running over. This MCP gives your AI client full control over field service workforces and time tracking. You manage everything—from scheduling new shifts for a crew member to adding precise, GPS-verified entries—all through natural conversation. Whether you're checking historical hours or setting up today’s assignments, the system handles it. Connecting this MCP via Vinkius puts all your job data, employee directories, and current schedules into one place where your agent can actually use it. It turns a messy series of clicks across multiple tabs into a simple chat command. ## Tools ### create_job Adds a brand new job or project code to your system directory. ### create_shift Schedules and books a new work shift for an employee. ### create_task Logs a brand new service task against a job site for tracking purposes. ### create_timesheet Manually adds an individual time entry record to the system. ### get_employee_details Retrieves specific information on a single staff member, like their current role or contact info. ### list_employees Gives you a full directory of all active and inactive employees in your company. ### list_jobs Displays the complete list of every job or project code currently managed by the system. ### list_schedules Shows all scheduled shifts for your team, letting you see who's working when. ### list_tasks Retrieves a list of every service task that has been created on site. ### list_timesheets Fetches detailed records of all time tracking entries for a specified period. ## Prompt Examples **Prompt:** ``` List all active employees in my ClockShark account. ``` **Response:** ``` I've retrieved your employee directory. You currently have 10 active staff members, including @user1 and @user2. Would you like to check the current timesheet for any of them? ``` **Prompt:** ``` Schedule a shift for 'John' (ID: 123) for tomorrow from 8 AM to 5 PM. ``` **Response:** ``` Shift scheduled! I've successfully assigned John to a new work shift for tomorrow. The assignment is now visible on your team's schedule. Shall I alert him via notification? ``` **Prompt:** ``` Show the timesheets for 'last_week'. ``` **Response:** ``` Fetching historical records... Last week, your crew logged a total of 320 hours across 5 active jobs. Highlights include 120 hours on the 'Riverfront Project'. Would you like the breakdown per employee? ``` ## Capabilities ### Manage workforce time records You get historical clock-in/out times and location data, letting you audit labor hours instantly. ### Plan and assign shifts The agent creates new work shifts or updates job assignments to keep your field crew coordinated. ### Track project expenses You monitor labor costs by creating service tasks and logging work types against specific projects. ### Maintain staff records The system pulls up complete employee profiles, whether they're active or retired from the field. ### Audit job scope details You ensure your crew always has access to the high-fidelity project and service codes they need for billing. ## Use Cases ### Quarterly payroll audit The Payroll Specialist needs to know total hours logged last quarter. They ask their agent, and it uses `list_timesheets` across all active jobs to pull the required data in one go. ### New site mobilization A supervisor starts a new job. Instead of filling out forms, they simply tell their agent to use `create_job`, instantly generating the project code needed for all future tasks and shifts. ### Checking staffing levels The Operations Manager needs to see who is available this week. They ask the agent to run `list_schedules` and cross-reference it with `list_employees` to find gaps. ### Mid-day task assignment A crew finishes one job early. The supervisor tells their agent to use `create_task`, assigning the remaining workers to a new, related project code immediately. ## Benefits - Stop manually compiling hours. Use the `list_timesheets` tool to instantly pull historical records, allowing you to audit crew time against job budgets. - Coordinate shifts without calling anyone. Simply tell your agent to use `create_shift`, and it assigns the work, making sure everyone is scheduled correctly. - Improve project cost accuracy. By using `create_task` and logging specific work types, you track labor costs directly against defined jobs. - Manage staff data easily. You can pull a full roster with `list_employees` or get deep details on one person using `get_employee_details` in seconds. - Keep job scope clear. Need to start a new project? Use `create_job`. Want to track work for it later? Reference the project code. ## How It Works The bottom line is: instead of navigating multiple menus and tabs, you talk to your AI client about your job site needs, and it executes the necessary commands automatically. 1. Subscribe to this MCP on Vinkius and retrieve your API Key from your ClockShark portal. 2. Connect that key to any compatible agent, like Cursor or Claude. 3. Tell your agent exactly what you need—for instance, 'Show me the timesheets for last week'—and it handles the rest. ## Frequently Asked Questions **How does the ClockShark MCP handle shift assignments?** You tell your agent to run `create_shift`. It schedules a new work period for an employee, making sure the assignment is logged against the correct job site. **Can I check historical hours using list_timesheets?** Yes. Running `list_timesheets` retrieves detailed records of all time tracking entries, letting you see exactly who worked when and where they were located. **What is the difference between create_task and create_timesheet?** Tasks (`create_task`) track general work types or services on a project. Timesheets (`create_timesheet`) are specific, individual records of clock-in/out hours. **Does list_employees show me inactive staff?** Yes, `list_employees` gives you the full directory, including both currently active and historically inactive staff members for record keeping. **When I use `create_job`, what essential data must I provide for a new project?** You need to supply the job name, associated client ID, and target completion date. The MCP verifies these inputs immediately, ensuring you start tracking work only on properly defined projects. **What specific information does `get_employee_details` retrieve for a staff member?** It pulls comprehensive records, including current role, department affiliation, and primary contact methods. This lets your agent pull up exactly what you need without leaving the chat. **How can I use `list_tasks` to check which service codes are available?** This tool displays every defined work type and associated project code in your system. This is key for making sure labor costs are always assigned using the correct, standardized classification. **What happens if I try to schedule a shift with `create_shift` that conflicts with existing entries?** The MCP validates the requested time block against your current schedules. If there's an overlap or scheduling conflict, it sends an error message immediately, preventing any bad data from getting logged. **How do I find my ClockShark API Key?** Log in as an Admin, navigate to **Admin** > **Integrations**, click on **Connect Zapier**, and copy your unique API Key. **Can the agent schedule new work shifts?** Yes! The `create_shift` tool allows the agent to assign a specific employee to a job with start and end times programmatically. **How do I retrieve a list of all jobs?** Use the `list_jobs` tool to retrieve your complete directory of active and archived projects directly from the platform.