MCP for Primavera P6

MCP for Primavera P6: Primavera P6 MCP Server

MCP for Primavera P6 is a local Model Context Protocol (MCP) server that connects Claude, ChatGPT, Cursor, VS Code and any other MCP client to your Oracle Primavera P6 Professional schedules on Windows. It reads the P6 database itself (P6 Professional standalone, SQLite) or plain XER files and answers scheduling questions with real computations: critical path and driving path, total float, the DCMA 14-point check, look-ahead, baseline and update comparison, CPM what-if and Monte Carlo schedule risk. Unlike XER-only MCP servers, it can also write changes back to the P6 database: durations, logic, constraints, actuals, units and UDFs, each one previewed in a dry run, applied only after your confirmation, backed up first and recorded in an edit log.

MCP for Primavera P6 is an independent project. It is not affiliated with, endorsed or sponsored by Oracle.

Oracle, Primavera and P6 are trademarks of Oracle and/or its affiliates.

Contents: What it does · Install · Connect your MCP client · Tools · Compared with XER-only servers · Safety · Privacy · P6 skills · FAQ · Troubleshooting

What it does

Ask your assistant "what drives the finish date?", "run a DCMA health check on the March update", "what changed since the last update?" or "what happens if procurement takes four more weeks?". The server computes the answer from the schedule; the model explains it. Dates and float come from P6's last schedule run (F9).

• Schedule analysis: projects and EPS, WBS roll-ups, activities filtered by status, float, dates, activity codes or UDFs, relationships with the project's lag calendar rule, critical path (total float or longest path), driving path, float paths, where an activity's float comes from, float distribution, look-ahead windows.
• Schedule quality: DCMA 14-point check with the project's own P6 thresholds, logic density and a weighted grade, comparison with earlier checks, out-of-sequence progress, dangling ends, redundant links.
• Comparisons, what-if and risk: two updates or a baseline compared activity by activity and link by link, with slip causes and float erosion; an integrity review of an update against the previous one (questions to raise, not proof); a CPM engine checked against P6's F9 (p6_cpm_validate reports the match) for what-if scenarios and Monte Carlo risk, run in memory and never written.
• Progress and reporting: S-curves and earned value at the data date, resource and cost summaries, groups by status, WBS or code, and a one-page Excel dashboard with native charts.
• XER files: inspect, import (new project, baseline, update), export, or analyse XER files alone in XER-only mode, without a P6 database or P6 installed.
• Edits (off by default): durations, constraints, actual dates, physical % complete, resource assignment units, activity UDF values, relationships, schedule options, EPS, deletes, backups and restore.

Install

MCP for Primavera P6 runs on Windows 10 or 11, next to P6 Professional. Nothing else to install: Python is bundled.

1. Download P6MCP-Setup- .exe from Releases and check it against SHA256SUMS.txt (certutil -hashfile P6MCP-Setup-2.0.0.exe SHA256).
2. Run it. It installs for your Windows user only (no administrator rights) and, on its last page, offers to register the server with every MCP client it finds (Claude Desktop, Claude Code, Cursor, VS Code, LM Studio, Cline). Untick the ones you do not want.
3. MCP for Primavera P6 Settings opens. Under Database, pick your P6 database (suggestions come from P6's own connection list), click Test connection (read only), then Use this database, and Save. The server never picks a database by itself: until you do this, every tool answers "No database configured".
4. Restart your MCP client completely.

Release builds are not code signed yet: Windows SmartScreen may warn on first launch ("More info", "Run anyway"). Check the SHA-256 first. Other packages on the release page: a portable zip (no installation) and an MCP bundle (.mcpb, server only) that Claude Desktop installs in one click; it is also the package listed in the official MCP Registry as io.github.nizarhamza/p6-mcp.

Connect your MCP client

The installer and Settings > MCP clients write the client configuration for you: they add (or repair, or remove) only the p6mcp entry, after a timestamped backup, keeping every other entry, comment and the file's formatting. The manual steps below are for reference. In every snippet, replace with your Windows user name (or copy the snippet from Settings > MCP clients > Other clients, which fills in the real path).

Claude Desktop

Either let the installer register it, or double-click the .mcpb bundle (Settings > Extensions shows it; pick the database there), or edit %APPDATA%\Claude\claude_desktop_config.json:

{

"mcpServers": { "p6mcp": { "command": "C:\\Users\\ \\AppData\\Local\\Programs\\P6 MCP\\p6mcp-server.exe", "args": [] } } }

Quit Claude Desktop completely (also from the notification area) and start it again. The P6 skills appear as prompts in the + menu.

Cursor

The installer registers it in %USERPROFILE%\.cursor\mcp.json, or add the same mcpServers entry as Claude Desktop above to that file. Cursor lists the tools under Settings > MCP.

VS Code (GitHub Copilot agent mode)

The installer registers it in %APPDATA%\Code\User\mcp.json (VS Code Insiders: ...\Code - Insiders\User\mcp.json). By hand, run MCP: Open User Configuration and add:

{

"servers": { "p6mcp": { "type": "stdio", "command": "C:\\Users\\ \\AppData\\Local\\Programs\\P6 MCP\\p6mcp-server.exe", "args": [] } } }

Then open Copilot Chat in Agent mode and pick the tools from the tools menu.

ChatGPT

ChatGPT cannot start a program on your PC, so there are two routes. Neither is tested by the maintainer yet: please report how it goes in an issue.

• Codex (in the ChatGPT desktop app, or the Codex CLI) starts local MCP servers from %USERPROFILE%\.codex\config.toml:

  [mcp_servers.p6mcp]

command = 'C:\Users\ \AppData\Local\Programs\P6 MCP\p6mcp-server.exe' args = []

• ChatGPT chat reaches MCP servers over HTTPS only. OpenAI's Secure MCP Tunnel runs a small client on your PC that starts the server (stdio command above) and forwards ChatGPT's requests to it, without opening an inbound port; you then add a custom MCP server in ChatGPT with Tunnel as the connection. It needs an OpenAI platform API key and a ChatGPT plan or workspace that allows custom MCP servers. The tool results then pass through OpenAI's service, like any ChatGPT conversation.

Claude Code, LM Studio, Cline and other clients

The installer registers Claude Code (%USERPROFILE%\.claude.json), LM Studio (%USERPROFILE%\.lmstudio\mcp.json) and Cline as well. For Claude Code by hand:

claude mcp add --scope user p6mcp -- "$env:LOCALAPPDATA\Programs\P6 MCP\p6mcp-server.exe"

Any other client that starts stdio servers takes the mcpServers snippet above. Clients that need HTTP can use the local HTTP transport. From the command line (the installer uses the same commands):

& "$env:LOCALAPPDATA\Programs\P6 MCP\p6mcp-server.exe" clients list

& "$env:LOCALAPPDATA\Programs\P6 MCP\p6mcp-server.exe" clients register cursor

Tools

58 tools: 37 read-only (11 of them in the Basic profile), 2 that write a file, 18 write tools (off by default; a dry run, then your confirmation; a backup first) and 1 that changes the app's own settings. Generated from the code by tools/gen_docs.py.

Projects and structure

Activities and relationships

Critical path and float

Schedule quality

| p6_redundant_links | Links that are candi