# Odoo Project MCP

> Odoo Project provides natural language control over your entire business operations within Odoo ERP. Manage projects, track every task, log timesheets, and maintain customer records without ever leaving your AI client. You get the full power of project coordination—from creating a new initiative to logging hours worked—all through simple conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-tracking, timesheets, resource-allocation, project-planning, milestone-tracking, collaboration

## Description

This MCP lets you manage your entire business inside Odoo ERP simply by talking to it. Instead of juggling dozens of tabs and jumping between CRM, accounting, and task boards, you direct your AI agent to handle everything. Need to know the status of an account? Ask for a list of sales orders or search for a specific lead right away. Want to scope out a new client initiative? You can set up a brand-new project record instantly. The power is in doing complex administrative actions—like logging time against a task, or updating a deadline—without ever needing to know the correct menu path. By connecting via Vinkius, you gain access to this powerful Odoo catalog from any compatible AI client, turning tedious data entry and context switching into simple conversations.

## Tools

### odoo_create_project
Sets up a brand new project record, optionally linking it to a customer or partner account within Odoo.

### odoo_create_task
Adds a new to-do item inside a project, allowing you to optionally assign it to a user with a specific deadline.

### odoo_list_projects
Retrieves an overview of all active projects, showing the manager, linked customer, task count, and date range.

### odoo_list_tasks
Lists project tasks across the system, showing assignee, progress stage (Kanban), priority, and deadlines.

### odoo_list_timesheets
Returns a list of timesheet entries detailing who worked, what project/task it was for, how many hours were logged, and the date.

### odoo_log_timesheet
Records billable time by linking hours to a specific task and project ID with a detailed description of the work performed.

### odoo_update_task
Modifies an existing task, letting you change its name, move its deadline, or adjust its priority level.

## Prompt Examples

**Prompt:** 
```
Search for leads from the website
```

**Response:** 
```
👥 **CRM Leads — Website**
| Name | Email | Stage | Revenue |
|---|---|---|---|
| Acme Corp | info@acme.com | Qualification | $15,000 |
| Beta Inc | hello@beta.io | Proposition | $8,500 |
```

**Prompt:** 
```
Show recent sales orders
```

**Response:** 
```
📋 **Sales Orders**
| SO# | Customer | Amount | Status |
|---|---|---|---|
| S00042 | Acme Corp | $12,500 | Confirmed |
| S00041 | Beta Inc | $3,200 | Draft |
```

## Capabilities

### Project Setup
You can create new projects for internal work or specific clients by providing a project title and optionally linking it to an existing partner.

### Task Management
The agent handles adding to-do items, assigning them to users, and setting deadlines within any given project scope.

### Project Status Lookup
You can request a list of all active projects, viewing key details like the customer linked, total tasks, and date ranges.

### Workload Tracking
The MCP reads task lists across all projects, showing assignees, progress status (Kanban stage), and deadlines at a glance.

### Time Logging
You can log time spent by detailing the hours worked, linking it to a specific project and task, and adding a description of the work completed.

### Data Modification
Need to change something? You can update an existing task's name, move its deadline, or adjust its priority level through conversation.

## Use Cases

### The Project Kickoff
A coordinator needs to start a new client initiative. They tell their agent, 'Start a project for Acme Corp.' The agent uses odoo_create_project to set up the record and then immediately follows up by using odoo_create_task to add the initial milestone tasks.

### End-of-Day Reconciliation
An analyst finishes work on several client accounts. Instead of filling out multiple forms, they ask their agent to log their hours via odoo_log_timesheet for all relevant projects and tasks in one go.

### Checking Team Capacity
A manager needs to know who is overloaded. They instruct the agent to list project tasks using odoo_list_tasks, filtering by assignee, which instantly shows their team's current workload and approaching deadlines.

### Client Follow-Up
An account manager needs to quickly check order status. They ask the agent for a list of recent sales orders (using prompt examples) and then use odoo_list_projects to confirm if that client has any ongoing projects.

## Benefits

- Stop switching tabs: Instead of navigating deep into Odoo's project module, you simply ask for a list of tasks or active projects, getting the data immediately in chat format. This saves minutes every hour.
- Accurate time tracking: You can log hours using odoo_log_timesheet without manually opening a timesheet form. Just tell your agent the task and the duration; it handles the record keeping.
- Real-time status checks: Want to know if that client project is on track? Asking for tasks via odoo_list_tasks gives you an instant dashboard view, showing who's assigned and what stage they are in.
- Streamlined planning: You can initiate a new work stream using odoo_create_project. This handles setting up the foundational record—all before you even assign the first task.
- Instant updates: Need to reschedule something? Using odoo_update_task lets you change deadlines or priorities for tasks without needing admin access to the specific module.

## How It Works

The bottom line is that you talk to one place, and it talks directly to Odoo.

1. You instruct your AI client that you need to perform a business action, like listing all active projects or searching for specific contacts.
2. Your agent calls the relevant tool within this MCP, sending only the necessary data (e.g., project ID or customer name) to Odoo.
3. Odoo executes the request and sends structured, actionable data back through your AI client chat window.

## Frequently Asked Questions

**How do I use odoo_log_timesheet with this MCP?**
You tell your agent how many hours you worked, what the description was, and which project/task it relates to. The agent then calls odoo_log_timesheet automatically for you.

**Can I check all my active projects with odoo_list_projects?**
Yes. Simply ask your agent to list the projects, and it will return a summary of every active project, including its customer link and total task count.

**Does odoo_create_task require me to know IDs?**
No. You tell the agent you want to add a task in Project X, and if needed, it will prompt you for any missing information like the assignee or deadline.

**What is odoo_list_tasks used for?**
This tool lists all tasks across your projects. You can ask to filter by project ID or view everything to get a full picture of current deadlines and progress stages.

**How do I update task details using odoo_update_task?**
Just tell the agent what you want to change, like 'Change the deadline for Task Y to next Tuesday.' The agent handles calling odoo_update_task with the correct parameters.