industream/mcp-odoo

MCP Odoo Server

Serveur MCP (Model Context Protocol) pour intégrer Odoo avec Claude et d'autres assistants IA compatibles MCP.

Fonctionnalités

Ce serveur MCP permet de gérer les données Odoo via une interface conversationnelle :

Gestion du temps (Timesheets)

• list_projects - Lister les projets disponibles
• list_tasks - Lister les tâches (filtrable par projet)
• list_timesheets - Lister les pointages
• get_timesheet_summary_by_employee - Résumé des heures par employé
• create_timesheet - Créer un pointage
• update_timesheet - Modifier un pointage
• delete_timesheet - Supprimer un pointage

Notes de frais (Expenses)

• list_expense_categories - Lister les catégories de dépenses
• list_expenses - Lister les notes de frais
• create_expense - Créer une note de frais
• update_expense - Modifier une note de frais
• delete_expense - Supprimer une note de frais
• add_expense_attachment - Ajouter une pièce jointe
• list_expense_attachments - Lister les pièces jointes

Contacts

• list_contacts - Lister les contacts (clients/fournisseurs)
• get_contact - Détails d'un contact
• create_contact - Créer un contact

Facturation

• list_invoices - Lister les factures
• get_invoice - Détails d'une facture

Ventes

• list_sale_orders - Lister les commandes/devis
• get_sale_order - Détails d'une commande

Produits

• list_products - Lister les produits
• get_product - Détails d'un produit

Ressources humaines

• list_employees - Lister les employés
• get_employee - Détails d'un employé
• list_departments - Lister les départements
• list_leave_types - Types de congés disponibles
• create_leave_allocation - Créer une allocation de congés
• list_leave_allocations - Lister les allocations
• approve_leave_allocation - Approuver une allocation
• create_public_holiday - Créer un jour férié
• list_public_holidays - Lister les jours fériés

Utilitaires

• test_connection - Tester la connexion Odoo
• search_records - Rechercher dans n'importe quel modèle Odoo
• get_rd_project_costs - Coûts des projets R&D

Installation

Prérequis

• Python 3.10+
• Une instance Odoo avec accès API
• Une clé API Odoo

Installation

# Cloner le repository
git clone https://github.com/industream/mcp-odoo.git
cd mcp-odoo

# Créer un environnement virtuel
python -m venv venv
source venv/bin/activate  # Linux/Mac
# ou: venv\Scripts\activate  # Windows

# Installer les dépendances
pip install -r requirements.txt

# Configurer les variables d'environnement
cp .env.example .env
# Éditer .env avec vos credentials Odoo

Configuration

Créez un fichier .env à partir de .env.example :

# URL de votre instance Odoo (sans slash final)
ODOO_URL=https://votre-instance.odoo.com

# Nom de la base de données Odoo
ODOO_DB=votre-instance

# Votre nom d'utilisateur (email)
ODOO_USERNAME=votre-email@example.com

# Votre clé API Odoo
ODOO_API_KEY=votre-cle-api

Obtenir une clé API Odoo

1. Connectez-vous à votre instance Odoo
2. Cliquez sur votre profil en haut à droite
3. Allez dans Préférences
4. Onglet Sécurité du compte
5. Section Clés API > Nouvelle clé API
6. Donnez un nom à la clé et copiez-la

Utilisation avec Claude Code

Ajoutez le serveur MCP dans votre configuration Claude Code (~/.config/claude-code/settings.json) :

{
  "mcpServers": {
    "odoo": {
      "type": "stdio",
      "command": "/chemin/vers/mcp-odoo/venv/bin/python",
      "args": ["/chemin/vers/mcp-odoo/server.py"],
      "cwd": "/chemin/vers/mcp-odoo"
    }
  }
}

Redémarrez Claude Code pour charger le serveur.

Exemples d'utilisation

Une fois configuré, vous pouvez demander à Claude :

• "Liste mes pointages de cette semaine"
• "Crée un pointage de 2h sur le projet X"
• "Montre-moi le résumé des heures par employé pour novembre"
• "Ajoute une note de frais de 50€ pour un repas client"
• "Liste les factures en attente"

Développement

Lancer les tests

pytest tests/

Structure du projet

mcp-odoo/
├── server.py          # Serveur MCP principal
├── requirements.txt   # Dépendances Python
├── .env.example       # Template de configuration
├── tests/             # Tests unitaires
└── README.md

Licence

MIT

Contributions

Les contributions sont les bienvenues ! N'hésitez pas à ouvrir une issue ou une pull request.