# Timeero MCP > Timeero gives your AI agent full control over field service workforce data. It connects to GPS-verified clock-ins, tracking mileage, timesheets, job pipelines, schedules, and user profiles for mobile teams. Use it to query current job status, list team members, or retrieve detailed work shifts directly through natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-tracking, gps-tracking, mobile-workforce, timesheets, field-service, timeero, mcp ## Description Timeero gives your AI agent full command over field service workforce data, handling everything from GPS-verified clock-ins to timesheets and job pipelines. You're checking current job status, listing team members, or pulling detailed work shifts without leaving your chat interface. **Directory Management: Who’s On Site?** You can pull the full staff directory using `list_timeero_users`, which returns a list of every account in Timeero, including their roles and current status. If you need specific profile details on one member, run `get_timeero_user` to fetch that person's complete data. **Time Tracking & Logging: Where Were They?** The system tracks time logs using GPS coordinates. You can retrieve a list of multiple recent employee time log entries by calling `list_timeero_timesheets`. For detailed information on one specific entry, use `get_timeero_timesheet`, pulling all the technical data and location metadata for that single clock-in. **Project & Job Status: What’s Happening Out There?** To see what projects are active in the field service pipeline, you'll call `list_timeero_jobs`, which returns a list of every currently running job. You can then drill down into any single project using `get_timeero_job` to pull all technical metadata and current status information for that defined job ID. **Task Assignments: What Needs Doing?** For assigned activities, you've got two ways to look at it. Call `list_timeero_tasks` to get a comprehensive list of every possible task available for an employee or project. To check the status and metadata for one specific activity within a job, use `get_timeero_task`. **Scheduling & Shifts: When Was It Supposed to Happen?** Coordinating shifts is simple. Use `list_timeero_schedules` to get every available work schedule record for review and coordination. If you just need the details for one specific shift or set of scheduled hours, run `get_timeero_schedule`. This gives you everything about a defined work shift. **System Health Check:** Before you start querying anything else, always run `check_timeero_status` to confirm the API connection is active and that all tools are working correctly. It's good practice. ## Tools ### get_timeero_job Retrieves detailed information and technical metadata for a single job ID. ### get_timeero_schedule Gets the full details for one specific work schedule or shift. ### get_timeero_task Pulls metadata and status for a specific assigned task within a job. ### get_timeero_timesheet Retrieves all technical details, including GPS coordinates, for one time log entry. ### get_timeero_user Fetches the full profile and directory details for a specific Timeero user. ### list_timeero_jobs Returns a list of all currently active jobs in the field service pipeline. ### list_timeero_schedules Lists every available work schedule record for coordination and review. ### check_timeero_status Confirms the API connection status to ensure all tools are working correctly. ### list_timeero_tasks Retrieves a list of all possible tasks that can be assigned to an employee or project. ### list_timeero_timesheets Lists multiple time log entries, allowing you to view the recent activity for your team. ### list_timeero_users Provides a list of every user account in Timeero, including their roles and status. ## Prompt Examples **Prompt:** ``` List all active team members in Timeero. ``` **Response:** ``` I've retrieved your team. You currently have 15 active high-fidelity profiles, including 'Mark' (Field Tech) and 'Lucy' (Supervisor). Would you like to see the current shift metadata for any of them? ``` **Prompt:** ``` Show the last 5 timesheets recorded. ``` **Response:** ``` Workforce orchestrated! I've identified 5 recent high-fidelity timesheet entries, including one for 'Mark' at 'Downtown Construction'. I've retrieved the technical duration and GPS metadata for your review. Shall I summarize the productivity? ``` **Prompt:** ``` Check the available tasks for the 'Repair' job. ``` **Response:** ``` Task catalog orchestrated! For the 'Repair' job, I've identified 3 active high-fidelity tasks. Your API connection is healthy. Shall I retrieve the detailed scheduling metadata for these tasks? ``` ## Capabilities ### List all active timesheets Retrieves a list of recent or specific employee time log entries. ### Get details for one job Pulls technical metadata and status information for a defined job ID. ### List current user directory Retrieves the complete list of active users and team member profiles in Timeero. ### Check work schedules Gets details for a specific shift or an entire group of scheduled shifts. ### List all jobs Retrieves a comprehensive list of active projects and job IDs available in the system. ### Get task details Pulls information on a specific assigned activity or task within a project. ## Use Cases ### The end-of-day payroll audit A Payroll Admin needs to confirm every technician clocked in properly. Instead of downloading multiple timesheets, they tell their agent: "Get me all timesheet entries for the last 24 hours.". The agent runs `list_timeero_timesheets`, pulling technical duration and GPS metadata that confirms clock-in validity across all field techs. ### Finding a project's scope An Ops Manager needs to know what jobs are running right now. They ask their agent: "List all active job IDs.". The agent executes `list_timeero_jobs`, giving them the names and statuses of every open project, so they can prioritize resources correctly. ### Checking team readiness for a site visit A Field Lead needs to know which crew members are available. They ask their agent: "Who is scheduled next week?" The agent calls `list_timeero_schedules` and pulls the schedule data, allowing the lead to confirm resource availability before dispatching anyone. ### Validating a new user's permissions An HR Admin needs to validate if a newly hired employee exists in the system. They ask: "Tell me about Mark Smith.". The agent runs `get_timeero_user`, retrieving the full profile data immediately, confirming their status and role without logging into the Timeero portal. ## Benefits - **Get accurate timesheets instantly.** Instead of manually checking spreadsheets, call `list_timeero_timesheets` to pull technical duration and GPS metadata for every team member's shift. This eliminates gaps in payroll data. - **Manage the entire job pipeline.** Use `list_timeero_jobs` to get a master list of all active projects. Then, use `get_timeero_job` to deep-dive into one project's specific status and required resources. - **Coordinate shifts without clicking through menus.** Running `list_timeero_schedules` gives you an immediate view of who is scheduled when. Your agent processes this list so you don't have to cross-reference multiple calendar views. - **Maintain a clean user directory.** Need to know what roles people have? Call `list_timeero_users`. You get the full profile details, letting your AI client pinpoint exactly which team member is assigned where. - **Stay on top of tasks in real time.** When a job needs specific activities, use `list_timeero_tasks` to pull the catalog. Then, check status with `get_timeero_task` to see if that activity was actually completed. - **Verify API connection health.** Start by calling `check_timeero_status`. This confirms your agent can talk to Timeero *before* you run a complex query, saving time and frustration. ## How It Works The bottom line is that the server translates your natural language questions into specific API calls, pulling verifiable workforce metrics from Timeero's backend. 1. Subscribe to the Timeero server and grab your API Token from the Timeero settings. 2. Configure your AI client (Claude, Cursor, etc.) with this token to authorize access. 3. Ask your agent a question like: "List all active jobs for field service." The agent executes `list_timeero_jobs` and returns structured data. ## Frequently Asked Questions **How do I list all active team members in Timeero with the timeero server?** Use `list_timeero_users`. This tool retrieves a complete directory of every user profile. You get basic status and role information for all team members at once. **What is the difference between list_timeero_jobs and getting job details?** `list_timeero_jobs` gives you a comprehensive overview, listing all available job IDs. If you need deep technical metadata—like specific task requirements or project goals—you must call `get_timeero_job` with the ID. **Can I check if my API connection is working before running complex reports?** Yes, use the `check_timeero_status` tool. This confirms your agent's ability to connect to the Timeero backend immediately, preventing failures on more critical data pulls. **Does get_timeero_timesheet include GPS info?** Yes. The `get_timeero_timesheet` tool retrieves high-fidelity time logs, including the specific GPS coordinates and technical duration for that entry. This is key for verifying work locations. **Which tool do I use to coordinate upcoming shifts?** You need `list_timeero_schedules`. Running this lists all available schedules, letting your agent help you check resource availability across multiple dates and users at once. **When I use `get_timeero_timesheet`, how do I get job-specific details for that entry?** The timesheet data provides a Job ID, but you need to run `get_timeero_job` separately. You pass the specific job ID from the timesheet result into the job tool call. This ensures your agent pulls all relevant project metadata alongside the time log. **What should I do if I hit a rate limit when running multiple commands like `list_timeero_users`?** The system enforces API rate limits to keep things stable. If you exceed them, your agent will receive a clear error code (429). Instead of spamming requests, use the `check_timeero_status` tool first or batch related queries into one prompt. **Do I need specific permissions to call `list_timeero_schedules`?** You must generate an API Token inside your Timeero account settings. This token is what authorizes the agent to run any tool, including schedule listings. Treat that key like a password; don't embed it anywhere other than the MCP configuration. **How do I find my Timeero API Token?** Log in to your account, navigate to **Account Settings** > **API**, and generate a new high-fidelity **Bearer Token**. **Can I check my team's schedules via AI?** Yes! The `list_timeero_schedules` tool allows your agent to retrieve high-fidelity work schedules and user shifts for operational coordination. **How do I list my active jobs?** Use the `list_timeero_jobs` tool to retrieve the complete high-fidelity directory of jobs along with their unique identifiers for precise orchestration.