OpenProject CE — Claude Code MCP server: what it does, how to install
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.
MIT ★ 45 updated 2026-10-29
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-mcpWhat OpenProject CE 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.
What it helps with
- 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 for the agent
- Show all tasks in project
demo-projectwith status In Progress - Create a Task work package in project
web-apptitled Configure CI and assign it to me - Log two hours to task 142 with comment Bug fixes
How to install OpenProject CE
Platform CLI
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-mcpReplace <…> 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>
Platform CLI
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-mcpReplace <…> 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>
Config file
{
"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>
Config file
{
"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>
Platform CLI
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-mcpReplace <…> 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>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OpenProject CE
How to install OpenProject CE in Claude Code?
Run `claude mcp add openproject-ce-mcp -e OPENPROJECT_BASE_URL=<OPENPROJECT_BASE_URL> -e OPENPROJECT_API_TOKEN=<OPENPROJECT_API_TOKEN> -- uvx openproject-ce-mcp` and restart Claude Code.
What does OpenProject CE do?
Connects AI agents to OpenProject Community Edition: the agent reads and creates projects, tasks, boards, meetings, logs time, manages memberships and versions. All writes go through preview and confirmation.
Which environment variables are required?
OPENPROJECT_BASE_URL and OPENPROJECT_API_TOKEN are mandatory. It is recommended to populate OPENPROJECT_READ_PROJECTS and OPENPROJECT_WRITE_PROJECTS with project identifier lists, otherwise most tools will not register.