---
id: odoorpc
version: "0.10.1"
license: LGPL v3
license_treatment: copyleft
maintenance: active
---

# OdooRPC — OdooRPC is a Python package providing an easy way to pilot your Odoo servers through RPC.

License: copyleft · Maintenance: active · Downloads: 135.7K/mo

## What it is and what it does

OdooRPC is a Python client that lets you interact with Odoo servers remotely using JSON-RPC or XML-RPC protocols. It mirrors the server-side API, so you can search records, browse data, execute workflows, manage databases, and download reports from Python code without needing direct database access. The library handles authentication, user context, and internationalization automatically.

You connect to an Odoo server by hostname and port, log in with credentials, then access models and records through a familiar object-oriented interface. It supports named parameters, record browsing, and raw queries, making it useful for automation scripts, integrations, and administrative tasks that need to manipulate Odoo data from outside the server.

Use it for:

- Automate data entry and updates in Odoo from external Python scripts or scheduled jobs
- Build integration layers between Odoo and third-party systems or databases
- Generate custom reports or analytics by querying Odoo data programmatically
- Manage multiple Odoo databases or perform bulk operations across instances
- Execute Odoo workflows and state transitions as part of external business processes

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

OdooRPC is a Python client library that connects to Odoo servers via JSON-RPC and XML-RPC protocols, allowing you to query data models, execute workflows, manage databases, and download reports programmatically.

Yes, if you need to automate or integrate with Odoo servers. The package has no dependencies, is actively maintained, and carries no known vulnerabilities. The LGPL v3 license is permissive for most use cases as long as modifications are shared. The main caveat is that the last release was over a year ago—verify compatibility with your specific Odoo version before relying on it for production.

## Install

pip install odoorpc
uv add odoorpc
poetry add odoorpc

## Installing OdooRPC

Before you install: Installation is straightforward with no runtime dependencies. The package is actively maintained with recent commits and has been stable since its early releases, though the last release was over a year ago.

License in practice: OdooRPC is licensed under LGPL v3, a copyleft license requiring that derivative works and modifications remain under the same license and be made available to users.

Quickstart:

pip install odoorpc

import odoorpc
odoo = odoorpc.ODOO('localhost', port=8069)
odoo.login('db_name', 'user', 'passwd')
user = odoo.env.user
print(user.name)

Verify before relying:

- Whether the package actively supports Python 3.7+ as stated, given classifiers list 3.4, 3.5, 3.6 but description claims 3.7+
- Current compatibility with recent Odoo server versions beyond the stated 8.0+ baseline

## Package facts

- License: LGPL v3 (copyleft)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 135.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

odoo rpc client, odoo server automation, odoo json-rpc python, odoo data model access, odoo workflow execution, odoo database management, remote odoo integration, odoo-integration, rpc-client, automation

[View on SkillFed](https://skillfed.io/packages/odoorpc) · [View on PyPI](https://pypi.org/project/odoorpc/)