OpenProject MCP Server

Name: OpenProject MCP Server
Author: io.github.alex13slem

io.github.alex13slem/openproject

Repository Registry

What is the OpenProject MCP server?

Manage OpenProject projects, work packages, files, relations, boards, users, and notifications.

How to install OpenProject

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OPENPROJECT_URL
required
Root URL of the OpenProject instance
OPENPROJECT_API_TOKEN
required
secret
OpenProject API token
OPENPROJECT_PAGE_SIZE
Default page size from 1 to 100
OPENPROJECT_TIMEOUT_MS
Request timeout in milliseconds from 1000 to 300000
OPENPROJECT_AUTH_MODE
API-token authentication mode: basic for broad compatibility or bearer for OpenProject 17.2+
OPENPROJECT_ALLOWED_UPLOAD_DIRS
Platform-separated directories from which attachment files may be read; defaults to the process working directory

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "openproject": {
      "command": "npx",
      "args": [
        "-y",
        "openproject-codex-plugin"
      ],
      "env": {
        "OPENPROJECT_URL": "<YOUR_OPENPROJECT_URL>",
        "OPENPROJECT_API_TOKEN": "<YOUR_OPENPROJECT_API_TOKEN>",
        "OPENPROJECT_PAGE_SIZE": "<YOUR_OPENPROJECT_PAGE_SIZE>",
        "OPENPROJECT_TIMEOUT_MS": "<YOUR_OPENPROJECT_TIMEOUT_MS>",
        "OPENPROJECT_AUTH_MODE": "<YOUR_OPENPROJECT_AUTH_MODE>",
        "OPENPROJECT_ALLOWED_UPLOAD_DIRS": "<YOUR_OPENPROJECT_ALLOWED_UPLOAD_DIRS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "openproject": {
      "command": "npx",
      "args": [
        "-y",
        "openproject-codex-plugin"
      ],
      "env": {
        "OPENPROJECT_URL": "<YOUR_OPENPROJECT_URL>",
        "OPENPROJECT_API_TOKEN": "<YOUR_OPENPROJECT_API_TOKEN>",
        "OPENPROJECT_PAGE_SIZE": "<YOUR_OPENPROJECT_PAGE_SIZE>",
        "OPENPROJECT_TIMEOUT_MS": "<YOUR_OPENPROJECT_TIMEOUT_MS>",
        "OPENPROJECT_AUTH_MODE": "<YOUR_OPENPROJECT_AUTH_MODE>",
        "OPENPROJECT_ALLOWED_UPLOAD_DIRS": "<YOUR_OPENPROJECT_ALLOWED_UPLOAD_DIRS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openproject": {
      "command": "npx",
      "args": [
        "-y",
        "openproject-codex-plugin"
      ],
      "env": {
        "OPENPROJECT_URL": "<YOUR_OPENPROJECT_URL>",
        "OPENPROJECT_API_TOKEN": "<YOUR_OPENPROJECT_API_TOKEN>",
        "OPENPROJECT_PAGE_SIZE": "<YOUR_OPENPROJECT_PAGE_SIZE>",
        "OPENPROJECT_TIMEOUT_MS": "<YOUR_OPENPROJECT_TIMEOUT_MS>",
        "OPENPROJECT_AUTH_MODE": "<YOUR_OPENPROJECT_AUTH_MODE>",
        "OPENPROJECT_ALLOWED_UPLOAD_DIRS": "<YOUR_OPENPROJECT_ALLOWED_UPLOAD_DIRS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "openproject": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "openproject-codex-plugin"
      ],
      "env": {
        "OPENPROJECT_URL": "<YOUR_OPENPROJECT_URL>",
        "OPENPROJECT_API_TOKEN": "<YOUR_OPENPROJECT_API_TOKEN>",
        "OPENPROJECT_PAGE_SIZE": "<YOUR_OPENPROJECT_PAGE_SIZE>",
        "OPENPROJECT_TIMEOUT_MS": "<YOUR_OPENPROJECT_TIMEOUT_MS>",
        "OPENPROJECT_AUTH_MODE": "<YOUR_OPENPROJECT_AUTH_MODE>",
        "OPENPROJECT_ALLOWED_UPLOAD_DIRS": "<YOUR_OPENPROJECT_ALLOWED_UPLOAD_DIRS>"
      }
    }
  }
}

Claude Code

claude mcp add openproject --env OPENPROJECT_URL=<YOUR_OPENPROJECT_URL> --env OPENPROJECT_API_TOKEN=<YOUR_OPENPROJECT_API_TOKEN> --env OPENPROJECT_PAGE_SIZE=<YOUR_OPENPROJECT_PAGE_SIZE> --env OPENPROJECT_TIMEOUT_MS=<YOUR_OPENPROJECT_TIMEOUT_MS> --env OPENPROJECT_AUTH_MODE=<YOUR_OPENPROJECT_AUTH_MODE> --env OPENPROJECT_ALLOWED_UPLOAD_DIRS=<YOUR_OPENPROJECT_ALLOWED_UPLOAD_DIRS> -- npx -y openproject-codex-plugin