# Odoo HR MCP for AI Agents AI Agent Connect

> Odoo HR MCP connects your Odoo ERP to your AI agent so you can manage staff, track time, and handle expenses without opening a browser. It lets you search the employee directory, request leave, check attendance, and monitor job openings through a simple conversation.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_o38i1WK3HHT3dHOszj8lGMKherLMmbz6Vgbqen6C/ai-agent-connect
- **Tags:** employee-management, attendance-tracking, leave-management, expense-reporting, workforce-analytics, onboarding

## Description

Imagine you're trying to figure out who's out of the office today or checking if a reimbursement was approved. Usually, that means logging into Odoo, navigating to the HR module, and digging through filters. This Connector changes that by letting your AI agent do the heavy lifting. You can just ask your agent to pull a list of pending expenses or find out which department a specific person belongs to. Instead of tab-switching, you're getting direct answers. It's like having an HR assistant who already knows your company's structure. Because Vinkius makes it so easy to plug this into your existing setup, you can start querying your workforce data immediately. It handles the boring stuff like looking up leave types or checking job vacancies so you can focus on actually managing the team.

## Tools

### odoo_list_jobs
Shows all current job openings and their recruitment status. It helps you track your hiring pipeline.

### odoo_create_leave
Submits a new leave request for an employee in draft status. It handles the standard approval workflow automatically.

### odoo_list_attendance
Pulls check-in and check-out times for your team. It shows total hours worked for easy daily tracking.

### odoo_list_departments
Lists all departments along with their managers and headcount. Use this to see the full company structure.

### odoo_list_employees
Provides a full directory of every employee. It includes job titles, departments, and contact info.

### odoo_list_expenses
Lists all employee expense reports. It shows the amount, status, and submission date for easy review.

### odoo_list_leave_types
Lists the different categories of time off available. It's useful for checking leave configurations.

### odoo_list_leaves
Shows all vacation and sick leave requests. It displays the status, duration, and dates for each.

### odoo_search_employees
Finds a specific person by name. It returns their manager, email, and hire date instantly.

## Prompt Examples

**Prompt:** 
```
Who is currently clocked in?
```

**Response:** 
```
### Current Team Attendance
| Employee Name | Check-in Time | Total Hours |
| :--- | :--- | :--- |
| Sarah Jenkins | 08:45 AM | 4h 20m |
| Marcus Chen | 09:12 AM | 3h 15m |
| Elena Rodriguez | 08:30 AM | 5h 00m |

*3 employees are currently active.*
```

**Prompt:** 
```
Show me all pending leave requests.
```

**Response:** 
```
### Pending Leave Requests
- **Sarah Jenkins**: Paid Time Off (Pending Approval)
- **David Wu**: Sick Leave (Pending Approval)
- **Jordan Smith**: Unpaid Leave (Draft Status)

*Total requests: 3*
```

**Prompt:** 
```
Find the manager for the marketing department.
```

**Response:** 
```
The manager for the **Marketing** department is **Elena Rodriguez**. She currently oversees a team of 12 employees.
```

## Capabilities

### Request employee time off
Submit new leave requests for staff members directly into the Odoo approval workflow.

### Pull real-time attendance logs
Get a list of check-in and check-out times along with total hours worked for your team.

### Browse the company org chart
View the full organizational structure including department managers and headcount.

### Track pending expense reports
Review employee reimbursement requests with their current approval status and amounts.

### View open job positions
Check your hiring pipeline to see current vacancies and their recruitment status.

### Search for specific staff members
Find any employee by name to get their title, department, and contact details instantly.

## Use Cases

### Checking who's in the office
An ops manager asks "Who's clocked in today?" and the agent uses odoo_list_attendance to provide a summary of the current team status.

### Onboarding a new hire
An admin asks for the manager of the marketing department and the agent finds it using odoo_list_departments to clarify the reporting line.

### Tracking expenses
A finance lead asks "What expenses are still pending?" and the agent pulls the list via odoo_list_expenses to identify items needing approval.

### Planning a vacation
A manager wants to see if someone can take next week off and uses odoo_list_leaves to check the team's existing vacation schedule.

## Benefits

- Get instant answers on team availability by using odoo_list_leaves to check who is out.
- Stop digging through menus to find staff info with odoo_search_employees for quick contact lookups.
- Monitor your hiring pipeline in real time using odoo_list_jobs to see open positions.
- Speed up reimbursements by pulling all pending expenses with odoo_list_expenses for easy auditing.
- Automate time-off requests by using odoo_create_leave to put requests into the draft state.
- View the entire company structure at a glance with odoo_list_departments to see manager assignments.

## How It Works

The bottom line is you get instant access to your Odoo HR data without leaving your chat interface.

1. Connect your Odoo instance to the Connector through your preferred AI client.
2. Grant the agent permission to access your HR and employee modules.
3. Ask questions about staff, leaves, or expenses in plain English.

## Frequently Asked Questions

**Can the Odoo HR MCP help me manage employee leaves?**
Yes, it can list current leave requests and even create new ones in draft status for your approval workflow.

**How does the Odoo HR MCP handle attendance tracking?**
It pulls real-time check-in and check-out times directly from Odoo, showing you who is working and their total hours.

**Can I use the Odoo HR MCP to find employee contact info?**
Yes, you can search for any staff member by name to quickly retrieve their email, job title, and manager.

**Does the Odoo HR MCP show me open job positions?**
It lists all current job vacancies in your Odoo instance along with their current recruitment status.

**Can I use the Odoo HR MCP to check expense reports?**
Yes, it allows you to pull a list of all employee expense reports, including the amounts and their current status.

**Can the Odoo HR MCP see my company's department structure?**
It can pull the full organizational structure, including department names, manager assignments, and total headcounts.

**Which Odoo versions are supported?**
This server uses the JSON-RPC protocol, which is compatible with Odoo 14, 15, 16, 17, and 18. Both Odoo Community and Enterprise editions are supported.

**Does it work with Odoo.com (SaaS)?**
Yes! Works with both Odoo.com hosted instances and self-hosted Odoo servers. Just provide your instance URL and API key.

**How do I generate an API Key?**
Go to Settings → Users → select your user → API Keys tab → New API Key. Give it a descriptive name and copy the generated key.