Skip to main content
Glama
projectlibre-mcp

projectlibre-mcp

by augmdc

projectlibre-mcp

Read-only MCP server for ProjectLibre .pod files. Lets Claude Code (or any MCP client) find your project files, summarize Gantt charts, inspect tasks, and analyze schedules — without opening ProjectLibre.

.pod parsing is done by MPXJ via JPype.

Requirements

  • Python 3.12+

  • Java 11+ on the PATH (required by MPXJ; e.g. brew install --cask corretto)

Related MCP server: Context Weaver

Setup

git clone https://github.com/augmdc/projectlibre-mcp.git
cd projectlibre-mcp
python3 -m venv .venv
.venv/bin/pip install -e .

Register with Claude Code

From the repo directory:

claude mcp add --scope user projectlibre -- \
  "$(pwd)/.venv/bin/python" -m projectlibre_mcp.server

Restart Claude Code and ask something like "Summarize my project Gantt chart". For other MCP clients, configure a stdio server with the same command.

Tools

  • list_projects() — find .pod files under your search roots

  • get_project_summary(path) — dates, counts, % complete, top-level outline

  • list_tasks(path, incomplete_only?, start_after?, finish_before?) — tasks with hierarchy, dates, and predecessors

  • analyze_schedule(path, as_of?, horizon_days?) — overdue / upcoming / critical-path tasks

Configuration

  • POD_SEARCH_ROOTS — colon-separated directories list_projects scans (default ~/Desktop:~/Documents). Pass it at registration time with claude mcp add --scope user --env POD_SEARCH_ROOTS="~/Projects" ....

Development

.venv/bin/pip install -e . pytest
.venv/bin/pytest

Set POD_TEST_FILE=/path/to/some.pod to enable the smoke test against a real file.

Limitations

Read-only. .pod is ProjectLibre's serialized-Java format; no library can safely write it. Planned edit path: write MS Project XML for ProjectLibre to open and re-save as .pod.

License

MIT

Available Tools

4 tools
analyze_scheduleA

Report overdue, upcoming, and critical-path tasks for a .pod project.

Args: path: Absolute path to the .pod file. as_of: Reference date YYYY-MM-DD (default: today). horizon_days: Window for upcoming tasks (default 30).

Inputs: path (required), as_of, horizon_days.

get_project_summaryA

Summarize a .pod project: dates, counts, completion, top-level outline.

Args: path: Absolute path to the .pod file (use list_projects to find it).

Inputs: path (required).

list_projectsA

Find ProjectLibre .pod files under the configured search roots.

Inputs: no named parameters. Returns: result

list_tasksA

List tasks in a .pod project with hierarchy, dates, and predecessors.

Args: path: Absolute path to the .pod file. incomplete_only: Drop summary rows and tasks at 100%. start_after: Keep tasks starting on/after this date (YYYY-MM-DD). finish_before: Keep tasks finishing on/before this date (YYYY-MM-DD).

Inputs: path (required), start_after, finish_before, incomplete_only. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a distinct and clear purpose: file discovery (list_projects), project overview (get_project_summary), task listing with filters (list_tasks), and schedule analysis (analyze_schedule). There is no overlap or ambiguity among them.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case (list_projects, list_tasks, get_project_summary, analyze_schedule). This makes the naming predictable and easy to understand.

    Tool Count5/5

    With 4 tools, the set is well-scoped for a ProjectLibre analysis server. Each tool serves a necessary function without being excessive or insufficient for common project management queries.

    Completeness4/5

    The tools cover the core analysis workflow: finding files, summarizing, listing tasks with filters, and performing schedule analysis. Minor gaps exist (e.g., no tool for detailed single-task info or resource data), but these do not hinder typical use cases for a read-only analytical server.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      This read-only MCP Server allows you to connect to Microsoft Project data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).
      8
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server that enables LLMs to read and analyze Microsoft Project schedules, including critical path, resources, and advanced construction planning layers (AWP and LPS) for work packages and Lean planning.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A read-only MCP server for PDF analysis that enables text extraction, image extraction, metadata retrieval, and text search via natural language.
      MIT