Odoo MCP Server Unofficial

🚀 Odoo MCP Server

Advanced and secure access to Odoo 18.0 (JSON-RPC) and Odoo Extraction API for OCR document parsing.

🚀 Quick Start (Command Line)

1. Clone the repository:

   git clone https://github.com/onlybets/odoo-mcp-server-unofficial.git
   cd odoo-mcp-server-unofficial
   

2. Configure credentials:

   cp .env.example .env
   # Edit .env and fill in your Odoo/Extraction credentials
   

3. Run with Cline (no need to self-host):

   • Cline will automatically run the server locally.
   • Just open the repository in Cline and start using the tools!

✨ Features

🛠️ Tools and JSON Schemas

1. list_models

Returns the models visible to the current user.

Input: None
Output:

[
  {"model": "res.partner", "name": "Contact"},
  {"model": "crm.lead", "name": "Lead"}
]

2. get_fields

Returns the fields and metadata of a model.

Input:

{ "model": "res.partner" }

Output:

{
  "id": {"string": "ID", "type": "integer", "required": true, "readonly": true},
  "name": {"string": "Name", "type": "char", "required": true, "readonly": false}
}

3. search_read

Searches for and reads records from a model.

Input:

{
  "model": "res.partner",
  "domain": [["is_company", "=", true]],
  "fields": ["id", "name", "email"],
  "limit": 10
}

Output:

[
  {"id": 7, "name": "Acme Corp", "email": "info@acme.com"}
]

4. create_record

Creates a new record in a model.

Input:

{
  "model": "res.partner",
  "values": {"name": "New Partner", "email": "new@partner.com"}
}

Output:

{ "id": 42 }

5. update_record

Updates one or more records in a model.

Input:

{
  "model": "res.partner",
  "ids": [42],
  "values": {"email": "updated@partner.com"}
}

Output:

{ "success": true }

6. delete_record

Deletes one or more records from a model.

Input:

{
  "model": "res.partner",
  "ids": [42]
}

Output:

{ "success": true }

7. extract_parse

Starts a document extraction task.

Input:

{
  "document_base64": "<base64-encoded-pdf>",
  "doc_type": "invoice",
  "version": "18.0"
}

Output:

{ "status": "processing" }

8. extract_status

Checks the status of an extraction task.

Input:

{
  "task_id": "<id>"
}

Output:

{
  "task_id": "<id>",
  "status": "completed",
  "result": {"key": "value"}
}

🔧 Technical Details

• Dependencies:

  • Python 3.8+
  • Flask
  • Redis (optional, for caching)

• Installation:

  pip install flask redis
  

• Running the server:

  python app.py
  

📄 License

MIT License

📚 Odoo MCP Protocol

https://modelcontextprotocol.org/