Timekeeping Agent App Overview
View timesheets, clock in and out, manage breaks, check attendance history, request time adjustments, and submit timesheets for approval — all through natural language conversation in Ask AI.
What is the Timekeeping Agent?
The Timekeeping Agent is an AI-powered time tracking assistant inside MangoApps Workforce. It integrates with the Ask AI sidebar to give employees conversational access to their timesheets, clock-in/out status, break management, attendance history, and time correction workflows. Instead of navigating through the Timekeeping module, you can ask “show my timesheet this week” or “clock me in” and get an instant response.
The agent uses an agentic LLM-with-tools architecture with eleven specialized tools covering the full timekeeping lifecycle — from viewing timesheets and clocking in, through break management, to submitting timesheets for approval. Actions that modify data (submitting timesheets, adjusting time entries) are flagged as risky and require confirmation or redirect to the Timekeeping portal for secure processing.
Core Value Proposition:
- Timesheet Viewing — Check your timesheet with daily breakdowns, regular hours, and overtime for any pay period
- Clock In/Out — Initiate clock-in/out actions through conversation (redirects to Time Clock for location verification)
- Break Management — Start and end breaks during your shift through Ask AI
- Attendance History — View detailed clock-in/out records with hours worked and missing checkout alerts
- Time Corrections — Request adjustments to time entries that route through manager approval
- Timesheet Submission — Submit completed timesheets for approval directly through the agent
At a Glance
| Timesheets | Clock In/Out | Breaks | Attendance | Adjustments | Submission |
|---|---|---|---|---|---|
| View hours, overtime, daily breakdown | Start/end work via Time Clock | Start and end breaks | History with clock times | Request time corrections | Submit for approval |
Perfect For:
- Employees — Quick access to timesheets, clock status, and time corrections without navigating the full Timekeeping app
- Managers — Review timesheet data and help team members with time adjustment workflows
- HR / Admin — Configure which timekeeping capabilities the agent exposes
How It Works
Agent Flow
┌──────────────────────────────────────────────────────────────────┐
│ TIMEKEEPING AGENT FLOW │
├──────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│ │ Ask AI │───▶│ Context │───▶│ Timekeeping Agent │ │
│ │ Sidebar │ │ Router │ │ (Agentic LLM) │ │
│ └──────────┘ └──────────────┘ └──────────────────────┘ │
│ │ │ │ │
│ User asks a Router detects Agent selects the │
│ timekeeping timekeeping intent right tool from 11 │
│ question and delegates available tools │
│ │
│ ▼ ▼ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ TOOL CATEGORIES │ │
│ ├──────────────┬──────────────┬────────────────────────────┤ │
│ │ View Tools │ Action Tools │ Risky Tools │ │
│ │ ────────── │ ──────────── │ ─────────── │ │
│ │ view_ │ clock_in │ submit_timesheet │ │
│ │ timesheet │ clock_out │ adjust_time_entry │ │
│ │ view_ │ start_break │ │ │
│ │ attendance │ end_break │ Require confirmation or │ │
│ │ view_ │ │ redirect to Timekeeping │ │
│ │ attendance │ │ portal for processing │ │
│ │ _history │ │ │ │
│ │ view_ │ │ │ │
│ │ missing_ │ │ │ │
│ │ checkouts │ │ │ │
│ └──────────────┴──────────────┴────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────┘
Key Capabilities & Tools
The Timekeeping Agent registers eleven tools covering the complete timekeeping workflow:
View Tools
| Tool | Description | Risky? |
|---|---|---|
| view_timesheet | View your timesheet for a period with daily breakdown, regular hours, overtime, and total hours | No |
| view_attendance | View attendance records with clock-in/out times, status, and hours worked | No |
| view_attendance_history | View detailed attendance history over a custom date range with optional break details | No |
| view_missing_checkouts | Find days where you forgot to clock out — flagged for time adjustment | No |
| submit_time | Submit a time entry for a specific date (redirects to Timesheets page) | No |
Action Tools
| Tool | Description | Risky? |
|---|---|---|
| clock_in | Clock in to start work — checks if already clocked in, redirects to Time Clock for location verification | No |
| clock_out | Clock out to end work — shows hours worked, redirects to Time Clock | No |
| start_break | Start a break (lunch, short, or rest) — requires active clock-in | No |
| end_break | End current break and resume work — redirects to Time Clock | No |
Risky Tools (Require Confirmation)
| Tool | Description | Risky? |
|---|---|---|
| adjust_time_entry | Request a time entry adjustment with a reason — routes through manager approval | Yes |
| submit_timesheet | Submit a timesheet for approval — shows total hours and redirects to portal for final confirmation | Yes |
Time Period Intelligence
| You Say | Agent Interprets |
|---|---|
| “today” | Current date |
| “yesterday” | Previous day |
| “this week” | Current Monday through Sunday |
| “last week” | Previous Monday through Sunday |
| “this month” | First to last day of current month |
| “this pay period” | Bi-weekly period based on current week |
| Custom dates | “March 1 to March 15” parsed as custom range |
Configurable Capabilities
Administrators can toggle capability groups through the app settings:
| Capability | Tools Controlled | Default |
|---|---|---|
| Timesheet Review | view_timesheet, submit_timesheet | Enabled |
| Payroll Reports | submit_time, adjust_time_entry | Enabled |
| Overtime Tracking | clock_in, clock_out, view_attendance, view_attendance_history | Enabled |
| Exception Detection | view_missing_checkouts | Enabled |
Break management tools (start_break, end_break) are always available and cannot be disabled.
Example Conversations
Viewing Your Timesheet:
You: “Show my timesheet for this week”
Agent: “Your timesheet for this week (03/03 – 03/09/2026):
- Status: draft
- Total Hours: 32.50
- Regular Hours: 32.50
- Overtime Hours: 0.00
Daily Breakdown:
- Monday: 8.25 hrs
- Tuesday: 8.00 hrs
- Wednesday: 8.25 hrs
- Thursday: 8.00 hrs
- Friday: (no entry yet)”
Clocking In:
You: “Clock me in”
Agent: “To clock in, please use the Time Clock feature which requires location verification. Go to Time Clock”
You: “Clock me in” (when already clocked in)
Agent: “You are already clocked in since 8:30 AM.”
Managing Breaks:
You: “Start my lunch break”
Agent: “To start a lunch break, use the Time Clock feature. Go to Time Clock”
You: “Start a break” (when not clocked in)
Agent: “You must be clocked in to start a break.”
Finding Missing Checkouts:
You: “Do I have any missing clock-outs?”
Agent: “Found 2 days with missing clock-out this month:
- March 1 (Saturday): Clocked in at 9:00 AM — missing checkout
- March 4 (Tuesday): Clocked in at 8:45 AM — missing checkout
Please submit time adjustments for these dates.”
Requesting a Time Adjustment:
You: “I forgot to clock out on March 4 — I left at 5:30 PM”
Agent: “Time adjustment requests must be submitted through the Timekeeping portal for manager approval. Navigate to Time Adjustments to submit your request with clock-out time of 5:30 PM.”
Submitting a Timesheet:
You: “Submit my timesheet for this week”
Agent: “Your timesheet for this week has 32.50 hours and is currently in draft status. Submit via the Timekeeping portal to send it for approval.”
User Roles & Permissions
| Role | What You Can Do |
|---|---|
| Employee | View own timesheets, clock in/out, manage breaks, view attendance, request adjustments, submit timesheets |
| Manager | All employee capabilities (scoped to own data through the agent) |
| HR / Admin | All capabilities plus configure agent settings and capability toggles |
All queries are scoped to the current business and the requesting user’s records.
Mobile Support
The Timekeeping Agent includes mobile web views accessible through the MangoApps native app:
| View | Description |
|---|---|
| Dashboard | Agent stats, enabled capabilities count, and recent activity |
| Capabilities | View which agent capabilities are currently enabled |
| Activity Log | Browse past agent actions with status and source filters |
Getting Started
- Open Ask AI — Click the Ask AI icon in your sidebar or navigation bar
- Ask a timekeeping question — Type naturally: “Show my timesheet” or “Am I clocked in?”
- Manage your time — Clock in/out, start breaks, and check hours all through conversation
- Fix issues — Find missing checkouts and request time adjustments with “Do I have missing clock-outs?”
Prerequisite: The Timesheets & Payroll module must be enabled for your business. The Timekeeping Agent becomes available automatically when the module is active.
Admin Setup:
- Navigate to the Timekeeping Agent app in the Marketplace
- Toggle individual capabilities (Timesheet Review, Payroll Reports, Overtime Tracking, Exception Detection) on or off
- All capabilities are enabled by default
Tips & Best Practices
- Check before clocking — Ask “am I clocked in?” to avoid duplicate clock-in attempts
- Review missing checkouts regularly — Ask “any missing clock-outs this month?” to catch forgotten punch-outs early
- Preview before submitting — Ask “show my timesheet this week” to review hours before submitting for approval
- Use pay period queries — Ask “show my timesheet for this pay period” to align with your organization’s payroll cycle
- Request adjustments with reasons — Always include a reason when requesting time corrections: “I forgot to clock out Tuesday — left at 5 PM for a dentist appointment”
Related Resources
| Resource | Description |
|---|---|
| Ask AI | The conversational AI sidebar where you interact with the Timekeeping Agent |
| Time & Attendance | The full time tracking module with clock-in/out, break compliance, and attendance records |
| Timesheet Export | Export timesheet data for payroll processing |
| Attendance Agent | AI agent for attendance reporting (read-only attendance data, complements Timekeeping Agent actions) |
| Scheduling Agent | AI agent for shift schedule viewing that works alongside timekeeping |
