Skip to main content
Glama
projectlibre-mcp

projectlibre-mcp

by Osyanne

projectlibre-mcp

MCP server para leer, analizar, crear y editar proyectos de ProjectLibre desde Claude, vía la librería MPXJ.

Cómo funciona

  • Lee .pod (nativo de ProjectLibre) y .xml (MS Project / MSPDI) directamente.

  • Escribe .xml (MSPDI). Para ver los cambios en ProjectLibre: File → Open el .xml generado (y, si quieres, Save As → .pod).

  • No se puede escribir .pod directamente (formato propietario); por eso la escritura produce .xml.

Related MCP server: OmniPlan MCP Server

Requisitos

  • Java (JDK 21 recomendado; JAVA_HOME configurado).

  • uv.

Instalación

uv sync

Registrar en Claude Code

claude mcp add -s user projectlibre -- uv run --directory "C:\Users\osyanne\Documents\Claude\Projects\projectlibre-mcp" projectlibre-mcp

Herramientas

Lectura / análisis (aceptan .pod o .xml):

  • summarize_project(file) — resumen: nombre, fechas, # tareas/recursos, hitos.

  • list_tasks(file, only_critical=False) — tareas con id, nombre, fechas, duración, %, predecesoras, recursos.

  • get_task(file, task_id) — detalle de una tarea.

  • list_resources(file) — recursos y sus asignaciones (tarea, unidades, trabajo).

  • critical_path(file) — ruta crítica y holgura por tarea.

Creación / edición (escriben .xml MSPDI para importar):

  • create_project(name, start_date, tasks, out) — proyecto desde cero. tasks = lista de {name, duration_days, predecessors?, resource?, percent_complete?, is_milestone?}. predecessors admite índices 1-based o nombres.

  • add_task(file, name, duration_days, predecessors?, resource?, out?)

  • update_task(file, task_id, fields, out?) — fields: name, duration_days, percent_complete, is_milestone, start.

  • remove_task(file, task_id, out?)

  • set_dependency(file, predecessor_id, successor_id, type="FS", lag_days=0, out?) — type ∈ {FS, SS, FF, SF}.

  • assign_resource(file, task_id, resource_name, units=100, out?)

En las herramientas de edición, out es opcional si la entrada ya es .xml (se sobrescribe); si la entrada es .pod, out (.xml) es obligatorio. Las fechas usan formato YYYY-MM-DD; las duraciones, días laborables.

Flujo típico

  1. Exporta tu proyecto desde ProjectLibre o crea uno con create_project.

  2. Pídele a Claude que lo lea/analice/edite — los cambios se guardan en un .xml.

  3. File → Open ese .xml en ProjectLibre para ver/persistir el resultado.

Limitaciones (v1)

  • La escritura genera .xml (requiere abrirlo en ProjectLibre para persistir como .pod).

  • critical_path lee valores de holgura/crítica ya calendarizados (archivos reales de ProjectLibre).

  • Detección automática de sobreasignación de recursos: trabajo futuro.

Desarrollo

uv run pytest -q     # suite completa

Stack: Python 3.12 · mcp (FastMCP) · mpxj (JPype sobre JDK 21) · pytest. Arquitectura en capas: jvm → io → model → reader/writer → server.

Available Tools

11 tools
add_taskC

Agrega una tarea a un proyecto y guarda el resultado en .xml (out o el .xml de entrada).

Inputs: file (required), name (required), duration_days (required), out, +2 more.

assign_resourceC

Asigna un recurso a una tarea (lo crea si no existe) y guarda en .xml.

Inputs: file (required), task_id (required), resource_name (required), out, +1 more.

create_projectA

Crea un proyecto desde cero y escribe un .xml que se abre en ProjectLibre.

start_date en formato YYYY-MM-DD. tasks: lista de objetos con
name, duration_days y opcionales predecessors (índices 1-based o nombres),
resource, percent_complete, is_milestone. out debe terminar en .xml.

Inputs: out (required), name (required), tasks (required), start_date (required).

critical_pathA

Ruta crítica y holgura (slack) por tarea. Requiere un archivo ya calendarizado.

Inputs: file (required).

get_taskC

Detalle de una tarea por su id (uniqueID).

Inputs: file (required), task_id (required).

list_resourcesC

Lista los recursos y sus asignaciones (tarea, unidades, trabajo).

Inputs: file (required).

list_tasksB

Lista las tareas con id, nombre, fechas, duración, %, predecesoras y recursos.

Inputs: file (required), only_critical.

remove_taskC

Elimina una tarea por id y guarda el resultado en .xml.

Inputs: file (required), task_id (required), out.

set_dependencyB

Crea una dependencia entre tareas. type ∈ {FS, SS, FF, SF}.

Inputs: file (required), successor_id (required), predecessor_id (required), out, +2 more.

summarize_projectB

Resumen del proyecto: nombre, fechas, # tareas/recursos e hitos.

Inputs: file (required).

update_taskB

Modifica campos de una tarea (name, duration_days, percent_complete, is_milestone, start).

Inputs: file (required), fields (required), task_id (required), out.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: task CRUD, resource assignment, dependency management, critical path, and project summary. No two tools overlap in functionality; descriptions clearly differentiate them.

    Naming Consistency4/5

    Tool names follow a consistent verb_noun pattern (e.g., add_task, list_tasks) except for critical_path, which is a noun phrase. This minor deviation does not significantly impair predictability.

    Tool Count5/5

    With 11 tools covering project creation, task/resource management, dependencies, and analysis, the count is well-scoped for a project management server. Each tool earns its place without being overwhelming.

    Completeness3/5

    The tool surface covers core CRUD for tasks and project creation, but lacks resource update/delete tools and a full project retrieval tool (beyond summary). These gaps may hinder workflows requiring resource lifecycle management.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      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/).
      9
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to read and analyze project schedule files in OmniPlan (.oplx) and Microsoft Project (.mpp) formats, answering questions about tasks, milestones, resources, and progress.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Read-only MCP server for ProjectLibre .pod files that enables finding project files, summarizing Gantt charts, inspecting tasks, and analyzing schedules without opening ProjectLibre.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude and other LLM clients to read and write Microsoft Project files directly, covering tasks, resources, assignments, dependencies, and critical path information without needing Microsoft Project open.
      MIT