# ClockShark MCP MCP > ClockShark lets you take full control of field crew hours, job costing, and scheduling using GPS-verified timesheets. You can programmatically list time entries, create shifts for specific jobs, and monitor labor costs across multiple projects with natural language commands. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-tracking, gps-tracking, timesheets, job-costing, shift-scheduling, workforce-management ## Description Need to keep track of where your crews are working and how many hours they clocked in? This MCP connects directly to ClockShark, letting you manage all field operations through conversation. You can pull detailed historical records, like checking specific clock-in/out times or looking up staff directories instantly. It's about automating the tedious work of payroll prep and project accounting. When your agent pulls data from this MCP, it’s executed inside a secure V8 isolate sandbox on Vinkius, guaranteeing that every single time entry and schedule change is recorded with an auditable trail. This means you get full visibility into exactly which tools were called, what data flowed through, and how the budget is being used for your crew—nothing happens in the dark. ## Tools ### create_job Adds a brand-new job or project code into the system directory. ### create_shift Schedules and records a new work shift for an employee. ### create_task Adds a specific, billable work task to the job directory. ### create_timesheet Manually adds a time entry record for an employee's hours worked. ### get_employee_details Retrieves specific profile information and records for one staff member. ### list_employees Gives a full list of every employee record in the system. ### list_jobs Pulls an exhaustive list of all active and past jobs/projects. ### list_schedules Displays a full directory of scheduled work shifts for the team. ### list_tasks Returns a complete list of all defined service tasks and project codes. ### list_timesheets Generates comprehensive lists of past time tracking entries for the crew. ## 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 ### List Staff Directories Get a list of all active or inactive employees currently in the system. ### Review Time Records Retrieve detailed lists of historical clock-in and clock-out timesheets for any crew member. ### Manage Job Locations View or programmatically list all service jobs and project codes your company tracks. ### Schedule Shifts Create new work shifts, assigning specific employees to jobs for a set time frame. ### Track Work Tasks List all service tasks and project codes used by the field crew. ## Use Cases ### The Payroll Audit It's the end of the month. Instead of manually cross-referencing dozens of spreadsheets, you simply ask your agent to `list_timesheets` for the last quarter. The agent gives you a summary report showing total hours logged and flags any missing entries or location gaps. ### The New Project Launch A client signs on, and you need to set up billing immediately. You use `create_job` first, then tell your agent to automatically generate the necessary tasks by calling `create_task`, ensuring all costs are tracked from day one. ### The Scheduling Conflict You realize two crews are scheduled for the same location next week. You ask the agent to check `list_schedules` and it immediately points out the overlap, allowing you to reschedule before any conflict happens on site. ### The Staff Inquiry A supervisor needs to know if a contractor is still active. Asking your agent to run `list_employees` followed by `get_employee_details` confirms their status and contact information instantly, all from one chat window. ## Benefits - Stop manually checking timesheets. You can use `list_timesheets` to pull historical clock-in/out records and location metadata immediately. - Never lose track of staff assignments. The agent manages shifts by using `create_shift` or `list_schedules`, keeping your team's operation perfectly coordinated. - Simplify job setup. You can use `list_jobs` to see all current projects, ensuring your crew always knows which codes and tasks to use. - Better labor budgeting means knowing the true cost of work. Use `create_task` or `create_timesheet` to track every minute against a specific project code. - Streamline team oversight by calling `list_employees` and using `get_employee_details` to verify staff status without opening multiple internal portals. ## How It Works The bottom line is you stop manually following up on missing paperwork or digging through complex spreadsheets. Your AI client handles all the operational coordination. 1. First, subscribe to this MCP on Vinkius. Then, grab your API Key from the ClockShark portal (usually found under Admin > Integrations). 2. Connect your AI agent using any MCP-compatible client like Cursor or Claude. Your agent now has access to all the scheduling and employee data. 3. Ask your agent a question—like 'Show me last week's timesheets for the Riverfront Project.' The agent uses the connected tools to pull and interpret the live data. ## Frequently Asked Questions **How do I use the create_job tool with ClockShark?** To add a new project, simply ask your agent to call `create_job`. You just need to provide a unique name and a description for the project. The MCP handles adding it cleanly to your directory. **What data is available when I run list_employees?** The `list_employees` tool returns an exhaustive roster, showing names and basic status information for all staff records in the system. You can then use `get_employee_details` to pull deeper info on specific people. **Can I automate scheduling using create_shift?** Yes. By calling `create_shift`, you tell your agent exactly who needs a shift and when it should happen. The system then writes that new assignment into the live schedule, keeping everything up to date. **How does list_timesheets help with job costing?** By calling `list_timesheets`, you get verifiable hours tied directly to specific jobs and tasks. This gives your accounting team the clean data they need for accurate cost reports. **How do I use `get_employee_details` to pull specific information about a staff member?** It returns the employee's full profile data, including their current status, contact info, and job history. You just need to pass an ID or name for a precise record check. **When I use `create_task`, what fields do I need to provide to accurately track labor costs?** You must specify the linked project code, required hours, and a detailed work type. Providing this context ensures the task links correctly for accurate job costing. **If I run `list_schedules`, how does my agent handle potential shift conflicts?** The response details the assignment time block, and your agent flags any overlaps or gaps in coverage. This lets you quickly adjust assignments before they become an issue. **What is the difference between `list_jobs` and `list_tasks`?** Jobs are high-level projects, while tasks represent specific services under a job code. Use `list_tasks` to see all defined service operations available for billing.