p6xer MCP Server

Official13 tools

by osama-ata · Python

An MCP server for Primavera P6 XER files.

io.github.osama-ata/p6xer-mcp-server MCP Server

This Model Context Protocol (MCP) server provides MCP-compatible access to Primavera P6 XER files. It is described as a “full-featured” solution and is built on the PyP6XER library. The repository indicates Python 3.12+ support and an MIT license, with 13 tools exposed via the server.

🛠️ Key Features

MCP server for Primavera P6 XER files
MCP-compatible integration
Built on PyP6XER
Published as p6xer-mcp-server (PyPI)

🚀 Use Cases

Reading or working with Primavera P6 scheduling export data in XER format
Integrating P6 scheduling content into MCP-based developer workflows

⚡ Developer Benefits

Fits into MCP tooling via a server identified as io.github.osama-ata/p6xer-mcp-server
Provides 13 tools for interacting with XER-related functionality
Uses Python 3.12+

⚠️ Limitations

Source data provided does not list specific tool names, supported operations, or configuration details

Topics

cpmp6schedulingxermcpmcp-serverproject-management

README.md7 KBView on GitHub

P6XER MCP Server

mcp-name: io.github.osama-ata/p6xer-mcp-server

PyPI version

A full-featured Model Context Protocol (MCP) server for Primavera P6 XER files, built on PyP6XER.

Exposes 13 Tools, 3 Resources, and 2 Prompts so any MCP-compatible AI client (Claude Desktop, Claude Code, Cursor, etc.) can interactively parse, query, and analyze .xer schedule files.

🚀 Features

🔧 Tools (13)

Tool	Description
`parse_xer_file`	Parse an XER file — project list, totals, status breakdowns
`get_project_activities`	Activities with filters: project_id, project_short_name, status, task_type
`get_critical_path`	Critical path activities (float ≤ 0), sorted by early start
`analyze_resource_utilization`	Planned/actual hours & costs per resource; over-allocation flags
`check_schedule_quality`	DCMA-style check: missing logic, long durations, high float, unresourced tasks
`get_resources`	List resources, optionally filtered by type
`get_resource_assignments`	Resource–activity assignments with enriched names and costs
`get_wbs`	Work Breakdown Structure hierarchy
`get_relationships`	Predecessor/successor relationships enriched with task codes
`get_calendars`	Calendar definitions with hours-per-period data
`get_schedule_summary`	At-a-glance stats: counts, date range, critical count
`get_earned_value`	EVM: PV, EV, AC, CV, SV, CPI, SPI, EAC per project
`get_activity_detail`	Full detail for one activity (preds + succs + resources)

📋 Resources (3)

URI	Description
`xer-project://{file_path}/{project_id}`	Detailed text summary of a specific project
`xer-activities://{file_path}`	Activities summary with status breakdown and duration stats
`xer-resources://{file_path}`	Resources summary with type breakdown and assignment stats

💬 Prompts (2)

Prompt	Types
`analyze_xer_project`	`general` · `schedule` · `resources` · `progress` · `quality`
`xer_reporting_prompt`	`executive` · `detailed` · `critical_path` · `resource` · `milestone`

� Install from Store

Via PyPI (uvx — no install needed)

bash

uvx p6xer-mcp-server

Via PyPI (pip)

bash

pip install p6xer-mcp-server
p6xer-mcp-server

Via Smithery

Search for p6xer-mcp-server on smithery.ai and click Install. It will generate the correct Claude Desktop config automatically.

Via GitHub MCP Registry

The server is listed in the GitHub MCP Registry. In Claude Code:

bash

claude mcp add p6xer -- uvx p6xer-mcp-server

Claude Desktop config (after PyPI install)

json

{
  "mcpServers": {
    "p6xer": {
      "command": "uvx",
      "args": ["p6xer-mcp-server"]
    }
  }
}

�📦 Installation

bash

# Clone the repo
git clone https://github.com/osama-ata/p6xer-mcp-server.git
cd p6xer-mcp-server

# Install with uv (recommended)
uv sync

# Or with pip
pip install "mcp[cli]>=1.6.0,<2.0.0" pyp6xer

🏃 Running

Development / MCP Inspector:

bash

uv run mcp dev src/p6xer_mcp_server/server.py

Stdio (Claude Desktop / Claude Code):

bash

uv run p6xer-mcp-server

🔌 Claude Desktop

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "p6xer": {
      "command": "uvx",
      "args": ["p6xer-mcp-server"]
    }
  }
}

Config file locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

🔌 Claude Code (CLI)

bash

claude mcp add p6xer -- uvx p6xer-mcp-server

💬 Example Prompts

Once connected:

code

Parse project.xer and give me an overview of all projects

What are all the critical path activities, sorted by start date?

Run a DCMA schedule quality check on project.xer

Calculate earned value metrics — what are the CPI and SPI?

Show all resource assignments for "John Smith"

What are the predecessors and successors of activity A1000?

List all over-allocated labor resources

Generate an executive summary report for project.xer

📊 Tool Reference

Filter parameters (most tools accept)

project_id – numeric P6 project ID (e.g. "1234")
project_short_name – project short name string (e.g. "PROJ1")

Status codes

TK_NotStart · TK_Active · TK_Complete

Task types

TT_Task · TT_Mile · TT_FinMile · TT_WBS

Resource types

RT_Labor · RT_Mat · RT_Equip

🗂️ Project Structure

code

p6xer-mcp-server/
├── src/
│   └── p6xer_mcp_server/
│       ├── __init__.py
│       └── server.py       # All tools, resources, and prompts
├── manifest.json           # MCPB bundle manifest
├── mcp.json                # MCP registry metadata
├── smithery.yaml           # Smithery registry configuration
├── pyproject.toml
└── README.md

📋 Requirements

Python ≥ 3.10
mcp[cli] >= 1.6.0, < 2.0.0
pyp6xer >= 1.16.0

📄 License

MIT

🚢 Publishing to PyPI (GitHub Actions + Trusted Publishing)

This repository includes a release workflow at .github/workflows/publish-to-pypi.yml based on the PyPA guide and pypa/gh-action-pypi-publish.

1) Configure Trusted Publishers

Create trusted publishers for this exact workflow file:

PyPI: https://pypi.org/manage/account/publishing/
TestPyPI: https://test.pypi.org/manage/account/publishing/

Use these values:

Owner: osama-ata
Repository: p6xer-mcp-server
Workflow file: publish-to-pypi.yml
Environment: pypi (for PyPI), testpypi (for TestPyPI)
Project name: p6xer-mcp-server

2) Create GitHub Environments

In repository settings, create two environments:

pypi
testpypi

Recommended security setup:

Require manual approval for pypi
No approval required for testpypi

3) Build locally (optional sanity check)

bash

python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*

4) Release flow

Push to main: publishes to TestPyPI
Push tag v* (for example v0.1.1): publishes to PyPI

bash

git tag v0.1.1
git push origin v0.1.1

Install

Tools (13)

parse_xer_fileget_project_activitiesget_critical_pathanalyze_resource_utilizationcheck_schedule_qualityget_resourcesget_resource_assignmentsget_wbs

Configuration

Environment variables

P6XER_API_KEYsecret

API key used to authenticate with p6xer service.

P6XER_ENDPOINT

Optional p6xer endpoint URL (default uses local p6xer daemon).

P6XER_LOG_LEVEL

Optional log verbosity level (e.g., DEBUG, INFO, WARN, ERROR).

Arguments

commanddefault p6xer-mcp-server

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "p6xer-mcp-server": {
      "command": "uvx",
      "args": [
        "p6xer-mcp-server"
      ],
      "env": {
        "P6XER_API_KEY": "<YOUR_P6XER_API_KEY>",
        "P6XER_ENDPOINT": "<YOUR_P6XER_ENDPOINT>",
        "P6XER_LOG_LEVEL": "<YOUR_P6XER_LOG_LEVEL>"
      }
    }
  }
}

io.github.osama-ata/p6xer-mcp-server MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

parse_xer_file

get_project_activities

get_critical_path

analyze_resource_utilization

check_schedule_quality

get_resources

get_resource_assignments

get_wbs

get_relationships

get_calendars

get_schedule_summary

get_earned_value

get_activity_detail

P6XER MCP Server

🚀 Features

🔧 Tools (13)

📋 Resources (3)

💬 Prompts (2)

� Install from Store

Via PyPI (uvx — no install needed)

Via PyPI (pip)

Via Smithery

Via GitHub MCP Registry

Claude Desktop config (after PyPI install)

�📦 Installation

🏃 Running

🔌 Claude Desktop

🔌 Claude Code (CLI)

💬 Example Prompts

📊 Tool Reference

Filter parameters (most tools accept)

Status codes

Task types

Resource types

🗂️ Project Structure

📋 Requirements

📄 License

🚢 Publishing to PyPI (GitHub Actions + Trusted Publishing)

1) Configure Trusted Publishers

2) Create GitHub Environments

3) Build locally (optional sanity check)

4) Release flow

Install

Configuration

Related servers