OpenProject MCP Server

Search, create, update, assign, and comment on OpenProject work packages.

Local serverstdio

What is the OpenProject MCP Server?

Search, create, update, assign, and comment on OpenProject work packages.

What it actually does

OpenProject also provides an official MCP server in Professional plans and above. As of July 2026, that server exposes read-only tools. This community project is a good fit when you need write operations, Codex-specific guidance, or support for Community Edition. See the official MCP documentation for the current capabilities of OpenProject's server.

  • Broad read and write coverage: — manage projects and work packages, upload
  • Community Edition friendly: — it uses the generally available OpenProject
  • Codex-native workflow: — tools and guidance are packaged together so Codex
  • Runs locally: — credentials stay in a private file on your machine, and

Configuration

  • Bun 1.3 or newer - Codex CLI with MCP support - An OpenProject API token with access to the projects you want to manage The plugin and its local MCP server run natively on macOS, Linux, and Windows. It uses stable OpenProject API v3 endpoints and does not require an OpenProject Enterprise add-on. If you use Community Edition, make sure API tokens are enabled in your instance.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the OpenProject MCP Server

{
  "mcpServers": {
    "openproject": {
      "command": "npx",
      "args": ["-y", "openproject-codex-plugin"],
      "env": {
        "OPENPROJECT_URL": "your-value",
        "OPENPROJECT_API_TOKEN": "your-value",
        "OPENPROJECT_BASE_URL": "your-value",
        "OPENPROJECT_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Bun 1.3 or newer - Codex CLI with MCP support - An OpenProject API token with access to the projects you want to manage The plugin and its local MCP server run natively on macOS, Linux, and Windows. It uses stable OpenProject API v3 endpoints and does not require an OpenProject Enterprise add-on. If you use Community Edition, make sure API tokens are enabled in your instance.
VariableDescriptionRequired
OPENPROJECT_URLEndpoint or connection string the server talks to.Yes
OPENPROJECT_API_TOKENCredential the server authenticates with.Yes
OPENPROJECT_BASE_URLEndpoint or connection string the server talks to.Yes
OPENPROJECT_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use OpenProject to Area.”
  • “Use OpenProject to Projects.”
  • “Use OpenProject to Attachments.”

Frequently asked questions

Search, create, update, assign, and comment on OpenProject work packages. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.