Odoo MCP Skeleton

This is a Python skeleton for an Odoo MCP server built with fastmcp.

It includes:

• FastMCP tool registration
• FastAPI HTTP service
• secret-key header authentication for /mcp
• Odoo JSON-RPC client wrapper
• Example read-only tools

Quick Start With uv

1. Install uv.
2. Enter the project directory.
3. Sync dependencies:

uv sync

4. Copy environment variables:

copy .env.example .env

5. Fill in:

• MCP_SECRET_KEY
• ODOO_BASE_URL
• ODOO_DB
• ODOO_USERNAME
• ODOO_PASSWORD

6. Start the server:

uv run uvicorn odoo_mcp.main:app --host 127.0.0.1 --port 8080

On Windows PowerShell, you can also use:

.\run.ps1

Authentication

Clients must send this header when connecting to the MCP endpoint:

secret-key: your-secret-value

Suggested MCP Endpoint

http://127.0.0.1:8080/mcp

Troubleshooting Logs

If you see this pattern:

GET /mcp HTTP/1.1 307 Temporary Redirect
GET /mcp/ HTTP/1.1 404 Not Found

it usually means the outer FastAPI app and the inner FastMCP app both added an /mcp path. This project mounts FastMCP at /mcp and configures the inner FastMCP HTTP app with path="/", so the final endpoint stays:

http://127.0.0.1:8080/mcp

If you see requests to these paths:

/.well-known/oauth-protected-resource
/.well-known/oauth-authorization-server
/.well-known/openid-configuration

those are MCP client OAuth discovery probes. They can return 404 when you use simple secret-key header authentication instead of OAuth.

Common uv Commands

uv sync
uv run uvicorn odoo_mcp.main:app --host 127.0.0.1 --port 8080
uv run python -c "import odoo_mcp; print('ok')"

Notes About fastmcp Versions

FastMCP has changed quickly across versions. This skeleton isolates the MCP-to-ASGI mounting logic in src/odoo_mcp/server.py. If your installed version exposes a different HTTP adapter, update only that file.

Example Tools

• odoo_healthcheck
• search_customers
• get_customer_detail
• list_sale_orders