Odoo Accounting

This MCP server lets you securely access Odoo Accounting data via a lightweight, Claude-ready Model Context Protocol interface. It exposes an API to query account journal entries for audit and analysis, and is designed for experimental use with Claude Desktop in non-production environments.

How to use

You use an MCP client (such as Claude Desktop) to connect to the Odoo Accounting MCP Server, which provides endpoints to search and retrieve accounting data. Start the server locally or configure Claude Desktop to manage the server lifecycle, then issue queries through the MCP interface to obtain relevant journal entries for audits and analysis.

How to install

Prerequisites: Python 3.8+ and a working internet connection for dependencies.

How to install

Clone the project, install dependencies, and run the server locally to expose an MCP API at http://localhost:8000. You can also configure Claude Desktop to manage the MCP server lifecycle.

git clone https://github.com/jeevanism/odoo-accounting-mcp.git
cd odoo-accounting-mcp

# Optional: create a virtual environment
python -m venv .venv
..venv\Scripts\activate

# Install dependencies
python -m pip install -r requirements.txt

# Run the MCP server (exposes RESTful API at http://localhost:8000)
python main.py

How to install

Alternatively, you can configure Claude Desktop to start and manage the MCP server for you using the provided configuration snippet.

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "cwd": "D:/jeevan-projects/odoomcp/odoo_account_mcp",
      "args": ["main.py"],
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_DB": "your_db",
        "ODOO_USERNAME": "admin",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

Additional sections

Configuration focuses on connecting to your Odoo instance and enabling search tools for accounting data. The MCP server runs Python code, and dependencies are installed via a requirements file. Security is important when handling Odoo credentials; keep env vars and secrets out of public access.

Available tools

odoo_connection

Establishes and maintains a secure connection to the Odoo instance to fetch accounting data.

accounting_data_tool

Provides specialized search and retrieval capabilities for account journal entries and related records.

claude_integration

Ensures compatibility with Claude Desktop and the Model Context Protocol for smooth tool usage.

rest_api_server

Exposes a RESTful API via FastAPI to enable external clients to query Odoo accounting data.