projectlibre-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@projectlibre-mcp summarize the Gantt chart for my project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.serverRestart 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.podfiles under your search rootsget_project_summary(path)— dates, counts, % complete, top-level outlinelist_tasks(path, incomplete_only?, start_after?, finish_before?)— tasks with hierarchy, dates, and predecessorsanalyze_schedule(path, as_of?, horizon_days?)— overdue / upcoming / critical-path tasks
Configuration
POD_SEARCH_ROOTS— colon-separated directorieslist_projectsscans (default~/Desktop:~/Documents). Pass it at registration time withclaude mcp add --scope user --env POD_SEARCH_ROOTS="~/Projects" ....
Development
.venv/bin/pip install -e . pytest
.venv/bin/pytestSet 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 toolsanalyze_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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Remote MCP server to read and edit GanttFather projects: tasks, dates, dependencies, critical path.
Read, analyze, and safely edit Microsoft Project MPP files.
MCP server for generating rough-draft project plans from natural-language prompts.
Read-only MCP server for interior design studios: projects, overviews, weekly activity. No writes.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceThis 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/).8MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives LLMs read-only access to Microsoft Project Online (Project for the Web) via the Microsoft Graph API.18 npmMIT
- AlicenseNot gradedqualityCmaintenanceMCP 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
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server for PDF analysis that enables text extraction, image extraction, metadata retrieval, and text search via natural language.MIT