# Lucca HR & Finance MCP

> Lucca HR & Finance Suite MCP connects your AI agent directly to Lucca, giving you full control over employee data. Use this tool to audit user directories, track leave balances (Timmi), process expense claims (Cleemy), and monitor timesheets in one chat session.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** hris, expense-management, leave-tracking, administrative-automation, employee-directory, payroll-support

## Description

This connector lets you manage complex HR and finance tasks through natural conversation. Instead of clicking through separate tabs for payroll, time off, or spending reports, you simply ask your agent what you need. You can get a complete list of employees, pull current leave balances across the company, or audit specific expense claims to ensure compliance. It's like having an administrator sitting beside you who knows every detail in Lucca and answers instantly. By connecting this MCP via Vinkius, your AI client gains access to all these core HR functions—from department mapping to timesheet extraction—so you can focus on analysis instead of data entry.

## Tools

### list_users
Pulls a full list of every employee in the Lucca HR directory.

### get_user
Retrieves detailed profile information for a specific employee using their unique UUID.

### list_departments
Generates a list of all departments and sub-units in the company organization.

### list_leaves
Shows active leave requests, referencing data from the Timmi Absence application.

### list_expense_reports
Lists all company expense reports using Cleemy mapping for easy review.

### list_expense_claims
Retrieves individual, specific claims within a defined expense report range.

### list_timesheets
Lists matching timesheet chunks for specified periods using Timmi arrays limits.

### get_leave_balances
Pulls the current, accurate leave balances for employees globally.

## Prompt Examples

**Prompt:** 
```
List all employees in the 'Engineering' department
```

**Response:** 
```
I've found 12 employees in the Engineering department. Highlights include Alex Smith (Senior Dev), Sarah Johnson (Team Lead), and Mark Rivera (DevOps). Would you like to see the detailed profile for any of them?
```

**Prompt:** 
```
What are the active leave requests since 2026-03-01?
```

**Response:** 
```
Retrieving leave requests… I've identified 5 active requests since March 1st. Sarah is out next week (Paid Leave), and Alex has a pending request for Friday (RTT). I can provide the exact date boundaries for these absences.
```

**Prompt:** 
```
Show me the last 3 expense reports in Cleemy
```

**Response:** 
```
I've retrieved the latest 3 expense reports: 1) 'Business Trip - Berlin' (€450, Approved), 2) 'Team Dinner' (€120, Pending), 3) 'Office Supplies' (€45, Processed). Would you like to see the individual claims for the Berlin trip?
```

## Capabilities

### Get employee directory information
Retrieve full lists and detailed profiles for every person in the company's HR records.

### Manage time off requests
Check current leave requests and pull precise, up-to-date vacation balances for any employee.

### Audit corporate spending
List company expense reports and drill down into individual claims to monitor financial status and currency details.

### Analyze team work hours
Extract detailed timesheet records for specific date ranges, helping map out project workload distribution.

### Map the company structure
Generate a full outline of all departments and sub-units within the enterprise organization.

## Use Cases

### Checking compliance before payroll runs
A finance specialist needs to verify all submitted claims. They tell their agent, 'List individual expense claims for Report XYZ.' The agent uses list_expense_claims and lists every item, status, and currency type so the specialist can approve everything without opening dozens of PDFs.

### Optimizing project staffing
A team lead needs to know if a key developer is available next month. They ask their agent for 'The leave balances for John Doe.' The agent uses get_leave_balances and immediately tells the lead exactly how many days of PTO are remaining, allowing them to schedule work around actual availability.

### Quickly auditing a former employee's tenure
An HR manager needs to confirm specific job details for an exit interview. They ask their agent to run get_user on the UUID and instantly receive the detailed profile, including the exact job title and hire date, saving minutes of manual database searching.

### Reviewing department structure changes
A director wants to see if two departments merged. They prompt their agent with 'List all company departments.' The tool uses list_departments to output the full, current organizational hierarchy, allowing them to map out structural boundaries quickly.

## Benefits

- Get instant team availability. Instead of checking the leave calendar manually, use tools like list_leaves to see all active requests at a glance.
- Streamline expense auditing. Review reports using list_expense_reports and then dive into specific transactions with list_expense_claims—all without leaving your agent interface.
- Pinpoint employee details instantly. Need to know an employee's manager or hire date? The get_user tool retrieves that deep metadata in seconds.
- Map your entire organization. Use list_departments to pull a clean, structured hierarchy of every department and sub-unit for better reporting.
- Track work hours precisely. Extract detailed timesheet chunks using list_timesheets so you can accurately allocate project resources across the team.

## How It Works

The bottom line is you talk to your agent like talking to an HR admin and it pulls structured, actionable data from Lucca.

1. Subscribe to this MCP on Vinkius, then provide your Lucca Subdomain and API Key.
2. Connect your preferred AI client (Claude, Cursor, etc.) using the credentials.
3. Ask a direct question—for example, 'What are all unapproved expense claims for Q2?'—and let your agent pull the data.

## Frequently Asked Questions

**How do I check current employee leave balances with Lucca HR & Finance Suite MCP?**
You use get_leave_balances to pull active vacation days globally. This tool provides the most current data on an individual's available time off.

**What is the best way to list company departments using Lucca HR & Finance Suite MCP?**
Simply ask your agent to use list_departments. It will enumerate the entire corporate structure, showing all parent and sub-units for organizational mapping.

**Can I audit multiple expense reports at once with list_expense_reports?**
Yes. You can prompt your agent to use list_expense_reports to see the summary of many different documents, helping you quickly identify which ones need further review.

**Do I need a UUID to get employee details using Lucca HR & Finance Suite MCP?**
Yes. The get_user tool requires the unique employee UUID for precise data mapping. This ensures your agent retrieves the correct, single source of truth profile.

**Is list_timesheets better than checking a spreadsheet manually?**
Absolutely. list_timesheets pulls structured chunks of time worked for specific date ranges directly from Lucca, saving you hours of manual data entry and comparison.