mpxj

library16.1.0pypypiunverified

Python wrapper for the MPXJ Java library for manipulating project file formats (MPP, MPD, XER, PMXML, Planner, etc.). Current version 16.1.0, requires Python >=3.6. Released regularly, roughly quarterly.

data crm-productivity

pip install mpxj

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MPXJ

mpxj

datapythonv16.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

UniversalProjectReader

✓ from mpxj import UniversalProjectReader

✗ from mpxj import UniversalProjectReader

Read a Microsoft Project MPP file and print tasks with durations.

from mpxj import UniversalProjectReader reader = UniversalProjectReader() project = reader.read('project.mpp') print(project.getProjectProperties().getProjectTitle()) for task in project.getTasks(): print(task.getName(), task.getDuration())

Debug

Known issues

gotchaMPXJ requires Java to be installed. The Java executable must be on the PATH or set via JAVA_HOME. JPype will fail silently with an obscure error if Java is not found.

fix

Install a JRE (e.g., OpenJDK 11) and ensure 'java' is in PATH or JAVA_HOME is set.

affects: all

deprecatedDirectly importing reader classes like MPPReader is not necessary; UniversalProjectReader detects formats automatically. Using specific readers may break if class names change.

fix

Use UniversalProjectReader instead of MPPReader or XERReader.

affects: >=15.0.0

gotchaThe returned project object uses Java-style getters (getTitle(), getName()) not Python properties. Attempting to access project.title will raise AttributeError.

fix

Use getter methods: project.getTitle(), task.getName(), etc.

affects: all

breakingIn v16.0.0, JsonWriter's writeTimephasedData property default changed to false. Code relying on timephased data in JSON output may break if not explicitly enabled.

fix

Set JsonWriter.setWriteTimephasedData(True) to include timephased data.

affects: >=16.0.0

Upgrade

Version history

16.1.0latest on PyPI · released Apr 4, 2026

Audit

Dependencies

jpype1requiredRequired to bridge Python with the MPXJ Java library.

javarequiredRequires a Java Runtime Environment (JRE) 8 or later to be installed on the system.

Agent activity

47 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/joniles/mpxj ↗

packagehttps://pypi.org/project/mpxj/ ↗

homepagehttps://www.mpxj.org ↗