OpenProject MCP Server 🚀

A professional Model Context Protocol (MCP) server that provides a robust interface to OpenProject API v3. Manage your projects, work packages, and activities directly through AI agents like Claude.

✨ Features

• 🛠️ Full Work Package Lifecycle: Create, list, search, and update work packages.

• 💬 Activity Support: List activities and add comments to any work package.

• 🏢 Multi-Project Management: Explore project hierarchies and subprojects.

• 🚀 Dual Interface: Seamlessly switch between MCP (stdio) and FastAPI (REST) modes.

• 🔒 Secure: Environment-based configuration with TLS verification support.

Related MCP server: OpenProject MCP Server

🛠️ MCP Tools Available

🚀 Quick Start

🐳 Docker (Recommended)

1. Build the image:

   docker build -t openproject-mcp .

2. Run as API:

   docker run -d -p 8000:8000 --env-file .env openproject-mcp

🤖 Integration with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "openproject": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--network=host",
        "--env-file", "/absolute/path/to/.env",
        "openproject-mcp", "mcp"
      ]
    }
  }
}

⚙️ Configuration

Create a .env file based on .env.example:

• OPENPROJECT_HOST: Your instance URL (e.g., https://myproject.openproject.com)

• OPENPROJECT_API_KEY: Your API key (v3)

• OPENPROJECT_TLS_VERIFY: Set to False for self-signed certs.

📄 License

MIT License.