P6-MCP

Primavera P6 MCP Server

A fully featured MCP server for Oracle Primavera P6. Point any MCP-compatible AI client at your XER files or a live P6 EPPM instance and start asking questions in plain language.

✨ Highlights

• 138 tools across one unified surface — the same tool works against both XER files and live P6 EPPM with no changes to your prompt
• Full XER parser — lossless read and write of Oracle Primavera XER format including all tables, CP1252 encoding, and calendar data
• DCMA 14-point schedule assessment — automated compliance check with pass/fail per metric and actionable findings
• Critical path & float analysis — forward/backward pass, driving path, near-critical activities, negative float detection
• Earned Value Management — CPI, SPI, EAC, TCPI, S-curves, and period performance from XER or live P6
• Resource utilization — histogram, leveling report, overallocation detection across all assignments
• Baseline comparison & schedule diff — compare any two XER snapshots or XER vs live P6 project
• Safe mutation by default — write-back tools are disabled until you set P6MCP_ENABLE_MUTATION=true; all mutations require confirm=True
• Three transports — stdio for desktop clients, Streamable HTTP and SSE for remote/Docker deployments
• Works with every major MCP client — Claude Desktop, Cursor, Windsurf, VS Code, Zed, Continue, OpenAI Agents SDK

🚀 60-Second Quickstart

Claude Desktop / Claude Code:

{
  "mcpServers": {
    "p6-mcp": {
      "command": "uvx",
      "args": ["p6-mcp", "serve", "--transport", "stdio"],
      "env": {
        "P6MCP_WORKSPACE_DIRS": "/path/to/your/xer/files"
      }
    }
  }
}

Cursor / Windsurf / VS Code:

{
  "mcp": {
    "servers": {
      "p6-mcp": {
        "command": "uvx",
        "args": ["p6-mcp", "serve", "--transport", "stdio"],
        "env": { "P6MCP_WORKSPACE_DIRS": "/path/to/your/xer/files" }
      }
    }
  }
}

Docker (HTTP transport):

docker run -p 8000:8000 -v /path/to/xer:/data ghcr.io/shamshirialireza/p6-mcp

CLI:

p6-mcp inspect schedule.xer       # table inventory and project list
p6-mcp dcma schedule.xer          # DCMA 14-point report
p6-mcp diff old.xer new.xer       # compare two schedules
p6-mcp export schedule.xer --format xlsx --output report.xlsx

📦 Installation

# Recommended — no install needed, always latest
uvx p6-mcp

# pip
pip install p6-mcp

# With optional extras (Excel export, charts, HTTP transport)
pip install "p6-mcp[excel,charts,http]"

# Docker
docker pull ghcr.io/shamshirialireza/p6-mcp:latest

📊 Tool Groups

🔌 Backend Support

⚙️ Configuration

See .env.example for a full template including P6 EPPM connection setup.

🔒 Security

• XER file access restricted to P6MCP_WORKSPACE_DIRS — path traversal blocked
• Mutation disabled by default; requires P6MCP_ENABLE_MUTATION=true plus confirm=True per call
• HTTP transport supports bearer token auth via P6MCP_AUTH_TOKEN
• P6 EPPM credentials never logged

📄 License

MIT © Alireza Shamshiri