# OpenProject CE

OpenProject CE — an MCP server for managing projects and tasks in OpenProject Community Edition through AI agents. Reads and modifies work packages, boards, meetings, and schedules.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 45 repo stars
- Author: jtauschl
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jtauschl/openproject-ce-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/openproject-ce

## What it does

Connects local agents to OpenProject CE via MCP stdio. The agent can create projects, work packages, subtasks, relations, boards and meetings, log time, manage memberships, versions, file storages, and user leave schedules. Image and text attachments are inlined into the model's context. Every write goes through two calls: preview and confirmation; there is no bypass.

The server returns short, typed responses instead of OpenProject API HAL payloads. Context reduction per request reaches 98% when fields are limited through the `select` parameter. The working scope is constrained by `OPENPROJECT_READ_PROJECTS` and `OPENPROJECT_WRITE_PROJECTS`: while they are empty, only tools for reading statuses, types, and the current user are registered.

Requires Python 3.10 or newer, an OpenProject API v3 token, and project identifier lists for read and write. Administration, schedule, and personal-data tools are opt-in via separate flags. Targets Community Edition strictly; Enterprise Edition features like portfolios and placeholders are not supported.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `OPENPROJECT_BASE_URL`, `OPENPROJECT_API_TOKEN`, `OPENPROJECT_READ_PROJECTS`, `OPENPROJECT_WRITE_PROJECTS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env OPENPROJECT_BASE_URL=<OPENPROJECT_BASE_URL> --env OPENPROJECT_API_TOKEN=<OPENPROJECT_API_TOKEN> --env OPENPROJECT_READ_PROJECTS=<OPENPROJECT_READ_PROJECTS> --env OPENPROJECT_WRITE_PROJECTS=<OPENPROJECT_WRITE_PROJECTS> --transport stdio openproject-ce -- uvx openproject-ce-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from openproject-ce-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add openproject-ce --env OPENPROJECT_BASE_URL=<OPENPROJECT_BASE_URL> --env OPENPROJECT_API_TOKEN=<OPENPROJECT_API_TOKEN> --env OPENPROJECT_READ_PROJECTS=<OPENPROJECT_READ_PROJECTS> --env OPENPROJECT_WRITE_PROJECTS=<OPENPROJECT_WRITE_PROJECTS> -- uvx openproject-ce-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from openproject-ce-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "openproject-ce": {
            "command": "uvx",
            "args": [
                "openproject-ce-mcp"
            ],
            "env": {
                "OPENPROJECT_BASE_URL": "<OPENPROJECT_BASE_URL>",
                "OPENPROJECT_API_TOKEN": "<OPENPROJECT_API_TOKEN>",
                "OPENPROJECT_READ_PROJECTS": "<OPENPROJECT_READ_PROJECTS>",
                "OPENPROJECT_WRITE_PROJECTS": "<OPENPROJECT_WRITE_PROJECTS>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from openproject-ce-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "openproject-ce": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "openproject-ce-mcp"
            ],
            "env": {
                "OPENPROJECT_BASE_URL": "<OPENPROJECT_BASE_URL>",
                "OPENPROJECT_API_TOKEN": "<OPENPROJECT_API_TOKEN>",
                "OPENPROJECT_READ_PROJECTS": "<OPENPROJECT_READ_PROJECTS>",
                "OPENPROJECT_WRITE_PROJECTS": "<OPENPROJECT_WRITE_PROJECTS>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from openproject-ce-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OPENPROJECT_BASE_URL=<OPENPROJECT_BASE_URL> -e OPENPROJECT_API_TOKEN=<OPENPROJECT_API_TOKEN> -e OPENPROJECT_READ_PROJECTS=<OPENPROJECT_READ_PROJECTS> -e OPENPROJECT_WRITE_PROJECTS=<OPENPROJECT_WRITE_PROJECTS> openproject-ce uvx openproject-ce-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from openproject-ce-mcp <command>

## When to use it
- connect an agent to OpenProject CE to read tasks, boards, and meetings
- create work packages, subtasks, and relations through a prompt
- log time to tasks and manage project memberships
- enforce write control through two-step confirmation
- receive compact responses instead of full API HAL objects

## Example prompts
- Show all tasks in project `demo-project` with status In Progress
- Create a Task work package in project `web-app` titled Configure CI and assign it to me
- Log two hours to task 142 with comment Bug fixes

## Similar
- [openproject-codex](https://affpapa.org/en/nevibecode/plugins/openproject-codex.md) — plugin · ★ 1596 repo stars
- [OpenProject](https://affpapa.org/en/nevibecode/mcp/openproject.md) — MCP server · ★ 9 repo stars
- [projectbrain-mcp](https://affpapa.org/en/nevibecode/mcp/projectbrain-mcp.md) — MCP server · 7440 installs
- [plate](https://affpapa.org/en/nevibecode/mcp/plate.md) — MCP server · 1908 installs
- [Asana Automation](https://affpapa.org/en/nevibecode/skills/asana-automation.md) — skill · 7100 installs
- [event-planning-timeline](https://affpapa.org/en/nevibecode/skills/event-planning-timeline.md) — skill · 6600 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
