Generate project reports from OpenProject data

This OpenProject MCP Server is built for team leaders who need intelligent, automatically generated project reports. Its core features are smart report generation (weekly, monthly, and progress reports), real-time project risk identification and assessment, team workload analysis with optimization suggestions, and a template system supporting custom report formats, including professional Japanese-style business report templates (weekly, monthly, and progress-report variants). It speaks the standard MCP protocol so it integrates directly with Claude Desktop, Cursor, and other AI tools, and it ships with a web-based template editor for creating and editing custom report templates.

Use it when a team leader or PM wants AI-generated status reports, risk assessments, or workload analysis pulled directly from OpenProject project data instead of compiling them manually. Three deployment solutions are offered with different maturity: the HTTP solution (port 8010) is the production-stable, recommended option; the FastAPI solution (port 8020) is feature-complete and recommended for development and testing, with interactive API docs at /docs; and the FastMCP solution is explicitly marked experimental, intended for technical evaluation rather than production use. Do not point production traffic at the FastMCP variant given that status.

• Report generation - generate_report_from_template, producing weekly, monthly, or progress reports from a chosen template and project ID (e.g. japanese_weekly_report).
• Risk assessment - assess_project_risks, identifying and evaluating project risk for a given project ID.
• Workload analysis - analyzes team members' workload and suggests optimizations.
• Template system - built-in Japanese-style weekly, monthly, and progress-report templates, plus custom templates authored through the web template editor.

Optionally start OpenProject itself with Docker (docker-compose up -d, default login admin/admin at http://localhost:8090). For the recommended HTTP solution:

cd solution-http
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e ../mcp-core
cp .env.example .env   # set OPENPROJECT_URL and OPENPROJECT_API_KEY
python3 -m src.main

This exposes a web UI at http://localhost:8010/web/template_editor.html, an MCP endpoint at http://localhost:8010/mcp, and a health check at /health. The FastAPI solution follows the same pattern on port 8020 (cd solution-fastapi, python app/main.py), adding interactive API docs at /docs. For Claude Desktop or Cursor, point an mcpServers entry at the running MCP endpoint (e.g. http://localhost:8020/mcp). Get an OpenProject API key from "My Account" -> "Access Tokens" inside OpenProject.

Team leaders and project managers running OpenProject who want AI-generated weekly/monthly/progress reports, project risk assessments, and team workload analysis, including teams that need professionally formatted Japanese-style business reports, without compiling that data by hand every reporting cycle.