# Lucca (HR & Finance Suite) MCP for AI Agents AI Agent Connect

> Lucca (HR & Finance Suite) connects your HRIS to your AI client so you can manage employee records, track leave requests in Timmi, and audit expense reports in Cleemy through simple conversation. It handles the heavy lifting of navigating HR software, letting you pull data and monitor team availability without switching tabs.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_gZYOHzUyyIEi6eVDxx2eZ6WhxnNfu0JnI5VQktg9/ai-agent-connect
- **Tags:** hris, expense-management, leave-tracking, administrative-automation, employee-directory, payroll-support

## Description

Managing an HRIS usually feels like a chore of clicking through endless nested menus. You want to know who's out today, but you have to open a separate tab, filter by date, and then cross-reference another sheet to get a clear picture. This Connector changes that by letting your AI agent do the navigation for you. Instead of hunting for data across multiple screens, you just ask your agent to pull up a specific employee's profile or summarize recent expense claims. It handles the specifics of the Lucca platform, including the leave tracking and expense modules. When you use this through the Vinkius marketplace, you're basically giving your agent a direct line to your company's administrative backbone. You can audit departments, check vacation balances, or grab timesheet chunks for a specific project without ever touching the dashboard yourself. It's about moving from manual data entry to just asking questions and getting answers. You can quickly see who's in which department or get a breakdown of spending without digging through folders. This means you can spend less time on administrative overhead and more time on the actual work of managing your team. Whether you're looking for a specific hire date or trying to reconcile a pile of receipts, the information is now just a conversation away. You get to stay in your flow without the constant context switching that slows down your day.

## Tools

### get_leave_balances
Check the current vacation balances for your employees. This is useful for knowing how much leave is remaining for a specific person.

### list_users
Get a full list of all employees in your HR directory. This is the fastest way to see everyone currently on your team.

### get_user
Pull detailed metadata and profile info for a specific employee. You can get job titles, hire dates, and manager info in one step.

### list_departments
See all departments within your company structure. This helps you quickly map out your organization's hierarchy.

### list_leaves
View all active leave requests from the Timmi application. You can use this to see who is away and when they'll be back.

### list_expense_reports
Get a list of company expense reports from the Cleemy module. It makes it easy to audit spending across different departments.

### list_expense_claims
See individual claims within a specific expense report. This allows you to verify specific costs and their current approval status.

### list_timesheets
Pull specific chunks of timesheet data from Timmi. Use this to see exactly how many hours were logged on a specific project.

## Prompt Examples

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

**Response:** 
```
I've found 12 employees in the Engineering department. Highlights include:

| Name | Title | Manager |
| :--- | :--- | :--- |
| Alex Smith | Senior Dev | Sarah Johnson |
| Sarah Johnson | Team Lead | Mark Rivera |
| Mark Rivera | DevOps | Sarah Johnson |

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**: Out next week (Paid Leave)
*   **Alex**: Pending request for Friday (RTT)

I can provide the exact date boundaries for these absences if you need them.
```

**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

### Pull employee profiles
Get job titles and hire dates for any staff member instantly.

### Check vacation balances
See exactly how much leave a specific person has left.

### Audit expense reports
View all company spending claims and their current status.

### Track team absences
See a list of everyone who is currently out of the office.

### Map company departments
Get a clear view of your organization's structural hierarchy.

### Extract timesheet logs
Pull work hour data for specific date ranges.

## Use Cases

### The HR Audit
An HR manager needs to verify the titles and managers for 50 people in the Engineering department. They ask the agent to list all users in that department to double-check the directory.

### The Budget Check
A finance lead needs to see if any expenses over 500 euros were approved last week. They ask the agent to list expense reports from Cleemy to spot potential overages quickly.

### The Project Planning
A team lead needs to know if the dev team is available for a sprint next week. They ask the agent to check leave balances and active leaves to plan the workload.

### The Deep Dive
An admin needs to find the specific UUID and metadata for a long-tenured employee for a tax form. They ask the agent to get the specific user data to avoid manual searching.

## Benefits

- Stop hunting for data: Use `list_users` and `get_user` to pull employee info instantly instead of searching through the Lucca dashboard. This saves time on routine HR requests.
- Faster expense auditing: Use `list_expense_reports` and `list_expense_claims` to spot spending issues in seconds rather than opening dozens of files. You can see statuses and currencies at a glance.
- Real-time availability: Use `list_leaves` and `get_leave_balances` to see who is out of the office without asking around on Slack. It gives you a clear view of who's available for meetings.
- Automated project tracking: Use `list_timesheets` to grab work logs for specific dates to see exactly how much time your team spent on a project. It makes project reporting much faster.
- Instant org mapping: Use `list_departments` to get a bird's eye view of your company structure whenever you need to update a report. You don't have to remember every sub-unit name.

## How It Works

The bottom line is you get to stop clicking through HR menus and start getting answers via chat.

1. Subscribe to the Lucca MCP on Vinkius.
2. Provide your Lucca subdomain and API key in your client settings.
3. Ask your agent to pull employee lists, check leave balances, or audit expenses.

## Frequently Asked Questions

**Can Lucca (HR & Finance Suite) help me see who is on vacation?**
Yes, it pulls active leave requests from the Timmi module so you can see team availability instantly. This makes it easy to plan meetings without checking multiple calendars.

**How does Lucca (HR & Finance Suite) handle expense reports?**
It connects to the Cleemy module, allowing you to list reports and view individual claims for auditing. You can see statuses, amounts, and currencies directly in your chat.

**Can I use Lucca (HR & Finance Suite) to find employee contact info?**
Yes, it can retrieve detailed profiles including job titles and hire dates for any user in your directory. It's a quick way to get staff details without navigating the HRIS menus.

**Does Lucca (HR & Finance Suite) work with my current AI client?**
It works with any MCP-compatible client like Claude, Cursor, or Windsurf once you connect it via Vinkius. You just need your Lucca subdomain and API key to get started.

**Can Lucca (HR & Finance Suite) help with timesheet tracking?**
It can extract timesheet chunks from Timmi so you can see how many hours were spent on specific projects. This helps with project management and understanding team workload.

**What's the difference between Cleemy and Timmi in Lucca (HR & Finance Suite)?**
Timmi handles leave and absences, while Cleemy is dedicated to managing company expense reports. The Connector handles both so you can query either one from the same chat.

**Can I see my team's vacation balances through my agent?**
Yes. Use the `get_leave_balances` tool with a specific User ID. Your agent will retrieve the active leave balances representing vacation arrays globally, including different types of absences (e.g. Paid Leave, RTT) managed in Timmi.

**How do I check the individual claims within an expense report?**
The `list_expense_claims` tool allows your agent to extract absolute bounded individual claims for a specific Expense Report ID. You'll see precise dates, amounts, and native currency payloads for each item in the report.

**Can my agent list all company departments defined in Lucca?**
Absolutely. Use the `list_departments` tool to retrieve the strict hierarchical organizational units. Your agent will report the department names and their hierarchy, helping you understand the company's structural boundaries.