Odoo17-Project_management-MCP
Odoo 17 Project Management MCP server for Codex and AI agents, with Docker support and project-scoped access control.
Install / Use
claude mcp add fatemeh-mohseni-AI -- npx -y github:fatemeh-mohseni-AI/Odoo17-Project_management-MCPIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
OperationsSupported Platforms
Our assessment of Odoo17-Project_management-MCP
Odoo17-Project_management-MCP scores 73/100 on our quality scale, 685th of 747 Operations skills we index.
Its MCP Server is 5.5 KB long, well organised into 8 sections with 7 code examples: a solid amount of guidance for an agent.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 8 days ago, so Odoo17-Project_management-MCP is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Odoo17-Project_management-MCP compared with similar skills
All 4 of these similar skills score higher than Odoo17-Project_management-MCP; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| Odoo17-Project_management-MCP (this skill)by fatemeh-mohseni-AI | 73 | 10 | 8d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.4k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install Odoo17-Project_management-MCP?
- Run
claude mcp add fatemeh-mohseni-AI -- npx -y github:fatemeh-mohseni-AI/Odoo17-Project_management-MCP. The install tabs above show the steps for each supported agent. - Which AI agents does Odoo17-Project_management-MCP work with?
- It is written for Claude Code, Claude Desktop and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is Odoo17-Project_management-MCP safe to use?
- It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is Odoo17-Project_management-MCP still maintained?
- The repository was last updated 8 days ago, so Odoo17-Project_management-MCP is actively maintained.
Skill content
View source on GitHubOdoo 17 Project Management MCP
A security-focused, remotely accessible Model Context Protocol server for managing work in the official Odoo 17 Project application. The primary runtime is a long-lived, authenticated Streamable HTTP service. It supports self-hosted and Docker-based Odoo through the documented XML-RPC external API.
Status: alpha (
0.2.1). Test against a staging Odoo database before enabling production writes.
راهنمای فارسی · Installation · Technical architecture · Tool catalog · Security
Architecture
flowchart LR
A["Codex"] -->|"HTTPS + Bearer token"| B["MCP Streamable HTTP"]
B -->|"XML-RPC"| C["Odoo 17 Project"]
Default endpoints:
- MCP:
http://SERVER_IP:31080/mcp - unauthenticated liveness check:
http://SERVER_IP:31080/health
/mcp requires Authorization: Bearer <MCP_AUTH_TOKEN>. Missing credentials return HTTP 401 and
an invalid token returns HTTP 403. stdio remains available only as an explicitly selected legacy
transport.
What it supports
| Area | Capabilities |
|---|---|
| Access boundary | Mandatory project-ID allowlist; optional assignee allowlist; indirect records are re-checked |
| Projects | List, read, create (feature-gated), and update planning settings |
| Board columns | List, create, reorder and edit project-scoped task stages |
| Tasks | Compact stage-filtered search, full single-task read, create, update, move, archive/unarchive and protected hard-delete |
| Planning | Assignees, estimates, deadlines, priority, workload, dependencies and blockers |
| Structure | Subtasks and milestones |
| Classification | Project tags and task tag assignment |
| Collaboration | Task chatter comments as the configured service account |
| Status | Independent Kanban stage and Odoo task-state changes |
| Time tracking | Official Timesheets integration when hr_timesheet is installed |
There is deliberately no generic execute_kw, model, domain, field or method tool. The MCP
cannot be converted into unrestricted access to the rest of Odoo.
For large projects, call list_project_stages once and then use
list_tasks(project_id=..., stage_name="In Progress", limit=25, offset=0). The stage filter runs
inside Odoo, not after retrieval. List results exclude descriptions, dependency arrays and audit
timestamps; use get_task(task_id) only for a selected task's full details.
Quick start — Docker Compose (recommended)
git clone https://github.com/fatemeh-mohseni-AI/Odoo17-Project_management-MCP.git
cd Odoo17-Project_management-MCP
cp .env.example .env
openssl rand -hex 32
Copy the generated token into MCP_AUTH_TOKEN and configure the Odoo service account and approved
database IDs in .env:
ODOO_URL=http://odoo17-test:8069
ODOO_DB=mcp_test
ODOO_USERNAME=ai-project-service@example.com
ODOO_API_KEY=repl…[redacted]
ODOO_ALLOWED_PROJECT_IDS=12
ODOO_ALLOWED_ASSIGNEE_USER_IDS=7,19
MCP_TRANSPORT=streamable-http
MCP_HOST=0.0.0.0
MCP_PORT=31080
MCP_AUTH_TOKEN=repl…[redacted]
MCP_PUBLISH_HOST=0.0.0.0
Attach the MCP container to the Odoo Docker network and start the persistent service:
export ODOO_DOCKER_NETWORK=odoo17_mcp_test_net
chmod 600 .env
docker compose up -d --build
docker compose ps
curl http://127.0.0.1:31080/health
Connect Codex from another machine:
export ODOO_MCP_TOKEN='the-…[redacted]'
[mcp_servers.odoo_project]
url = "http://SERVER_IP:31080/mcp"
bearer_token_env_var = "ODOO_MCP_TOKEN"
enabled = true
required = true
startup_timeout_sec = 30
tool_timeout_sec = 120
default_tools_approval_mode = "writes"
[mcp_servers.odoo_project.tools.delete_task]
approval_mode = "prompt"
[mcp_servers.odoo_project.tools.delete_timesheet]
approval_mode = "prompt"
Use direct HTTP only on a trusted private network/VPN. For traffic crossing an untrusted network,
terminate HTTPS in a reverse proxy; an example is provided in
deploy/nginx.conf.example.
See the installation guide for ID discovery, firewall/TLS guidance, local Python installation, troubleshooting, and the optional legacy stdio mode.
Safe defaults
- Streamable HTTP is the default transport and cannot start without a bearer token of at least 32 characters.
- An empty project allowlist stops normal operation unless creation-only bootstrap is explicitly enabled.
- Project creation and permanent deletion are off by default.
- Hard deletion additionally requires an exact record-specific confirmation phrase.
- Credentials are never returned by tools or written to audit logs.
- Global stages and stages shared with a disallowed project are read-only through this MCP.
The MCP allowlist is a second boundary, not a replacement for Odoo ACLs and record rules. Use a dedicated least-privilege Odoo account restricted to the same projects.
Compatibility
- Odoo major version: 17 only
- Odoo deployment: self-hosted package or Docker, reachable over HTTP(S)
- Default MCP transport: Streamable HTTP on
/mcp - Optional legacy transport: stdio with
MCP_TRANSPORT=stdio - MCP SDK: official Python SDK
2.x - Timesheets: official
hr_timesheetfeature required
Development
make install
make lint
make test
make build
Development Notes
This repository is maintained as part of an ongoing development and learning process.
See CONTRIBUTING.md. Licensed under the MIT License.
Related Skills
Agent-Reach
112.4kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
