Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What 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-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

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-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>

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.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open