# Buddy Punch MCP for AI Agents AI Agent Connect

> Buddy Punch MCP lets you manage employee time tracking, schedules, and payroll data through your AI agent. It handles GPS-verified clock-ins, PTO, and timesheet exports for enterprise teams. Stop digging through spreadsheets; let your agent handle the heavy lifting of workforce administration.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_mKCL5yGGaFte0UOqP7hHJ80EvbHNsqE5Hyk0Kr00/ai-agent-connect
- **Tags:** time-tracking, attendance-monitoring, gps-tracking, timesheets, pto-management, workforce-scheduling

## Description

Buddy Punch lets you connect your enterprise account to an AI agent to manage workforce time tracking and payroll workflows through natural conversation. Instead of digging through complex shift tables or chasing down missing time cards, you can use your AI agent as a dedicated workforce administrator. You can pull time entries for specific pay periods, monitor shift distributions, and manage employee profiles without ever opening the dashboard. This connection makes it easy to handle high-fidelity punch actions and maintain your financial records through simple queries. By integrating this into your workflow through Vinkius, you move from manual data entry to high-level oversight, letting your agent handle the repetitive tasks of attendance monitoring and schedule management.

## Tools

### create_employee
Add a new staff member to your directory directly through your agent. This keeps your records current without manual form entry.

### list_employees
Get a full list of your current employees to check statuses or IDs. Use this to quickly verify who is currently active.

### punch_in_out
Record a punch action for an employee, including specific notes or metadata. Use this to manually fix missing clock-ins.

### list_pay_periods
View all defined pay periods to coordinate payroll cycles. This helps you stay aligned with your company's financial calendar.

### list_work_schedules
See your team's published shifts and distribution across the week. It helps you monitor labor capacity in real time.

### list_time_entries
Pull detailed time cards and entry history for any given period. This is perfect for preparing payroll summaries.

## Prompt Examples

**Prompt:** 
```
List all active employees in my Buddy Punch account.
```

**Response:** 
```
I've retrieved your employee directory. You currently have 15 active staff members, including **John Doe** (ID: 1024) and **Jane Smith**. 

| Name | ID | Status |
| :--- | :--- | :--- |
| John Doe | 1024 | Active |
| Jane Smith | 1025 | Active |

Would you like to check the current punch status for any of them?
```

**Prompt:** 
```
Punch in employee '1024' with the note 'Starting early morning shift'.
```

**Response:** 
```
✅ **Punch complete!**

I've recorded a **Punch In** for employee **1024** at 7:55 AM. 

*   **Note:** Starting early morning shift
*   **Status:** Recorded

Shall I check their scheduled end time?
```

**Prompt:** 
```
Show the time entries for the current pay period.
```

**Response:** 
```
Fetching pay period data... 

For the current cycle, your team has logged a total of **480 hours**. 

**Highlights:**
*   **John Doe:** 40 hours
*   **Jane Smith:** 38 hours

Would you like the high-fidelity break metadata?
```

## Capabilities

### Record employee punches
Log punch-in and punch-out actions with specific shift notes.

### Manage employee profiles
Create and list staff members to keep your directory current.

### Track pay periods
Retrieve historical and future pay cycles for payroll reporting.

### Monitor work schedules
See your team's published shifts and distribution at a glance.

### Pull time entries
Get detailed history of hours worked for any given period.

## Use Cases

### Missing Clock-ins
An employee forgets to punch in. The manager asks the agent to punch them in at 8 AM with a 'Late arrival' note using punch_in_out.

### Payroll Prep
A payroll specialist asks the agent to summarize all hours worked in the last two weeks to verify against the current pay period using list_time_entries.

### Schedule Audit
An operations lead wants to see if there's enough coverage for the night shift and asks the agent to list all work schedules using list_work_schedules.

### New Hire Onboarding
An HR person adds a new hire to the system immediately after a signed offer letter by giving the agent the employee details to use create_employee.

## Benefits

- Stop chasing missing time cards by using punch_in_out to quickly log manual entries for employees who forgot to clock in.
- Get instant visibility into team distribution by using list_work_schedules to see who is working when without opening the dashboard.
- Simplify payroll prep by pulling all data for a specific cycle with list_time_entries and list_pay_periods.
- Keep your directory current without manual data entry by using create_employee to add new hires on the fly.
- Reduce errors in payroll reporting by pulling structured, high-fidelity time data directly into your reporting workflow.
- Monitor real-time workforce capacity by asking your agent to summarize current shift updates and employee statuses.

## How It Works

The bottom line is you get a voice-controlled interface for your entire workforce management system.

1. Subscribe to the Buddy Punch MCP on Vinkius.
2. Get your Subscription Key from the Buddy Punch Developer Hub.
3. Connect the key to your AI client to start managing your team's attendance.

## Frequently Asked Questions

**Can Buddy Punch MCP handle manual clock-ins for employees who forget to punch?**
Yes. You can ask your agent to log a manual punch for any employee. It will record the time and any notes you provide, like 'forgot to clock in,' which keeps your records accurate for payroll.

**How does Buddy Punch MCP help with payroll preparation?**
It streamlines payroll by pulling structured time entry data directly into your chat. You can ask for summaries of specific pay periods or check total hours worked by individual staff members.

**Can I see my team's shift schedules using Buddy Punch MCP?**
Yes. You can ask your agent to list work schedules to see who is working, when they are working, and how your team is distributed across different shifts.

**Does Buddy Punch MCP support GPS-verified clock-ins?**
Yes. Because it connects to your Buddy Punch Enterprise account, it can access and report on GPS-verified punch data to ensure your team is clocking in from the correct locations.

**Can I add new employees to my directory via Buddy Punch MCP?**
Yes. You can give your agent the details of a new hire, and it will create their employee profile in your Buddy Punch account automatically.

**Is Buddy Punch MCP suitable for large enterprise teams?**
Yes, it is designed for Buddy Punch Enterprise accounts. It allows large organizations to manage high volumes of time cards and complex schedules through a conversational interface.

**How do I find my Buddy Punch Subscription Key?**
Log in to the Buddy Punch Developer Hub, navigate to your profile, and copy your Subscription Key (requires an active Enterprise plan).

**Can I punch in an employee via AI?**
Yes! The `punch_in_out` tool allows your agent to record a punch action by providing the employee ID and punch type (In/Out) programmatically.

**How do I retrieve time entries for payroll?**
Use the `list_time_entries` tool to retrieve detailed historical records of all work duration and breaks for the current pay period.