Log inSubmit server
OpenProject logo

OpenProject

Connects AI clients to OpenProject API v3 for work packages, projects, attachments, Git activity, time tracking, and reporting.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install OpenProject

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "openproject": {
      "command": "uvx",
      "args": [
        "openproject-mcp-server"
      ],
      "env": {
        "OPENPROJECT_URL": "YOUR_VALUE_HERE",
        "OPENPROJECT_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command installed and started the server, which then stopped for configuration (such as an API key) that our sandbox does not have — expected for servers that connect to your account.

uvx openproject-mcp-server

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 4d ago.

Overview

The OpenProject MCP server connects AI clients to the OpenProject API v3 for managing work packages, projects, comments, relations, attachments, and related delivery data. It runs as a Python MCP service, authenticates with an OpenProject URL and API key, and returns structured tool results. Use it to query or update self-hosted OpenProject data from an MCP-compatible client, particularly Community edition instances. The repository also describes support for Git and pull-request activity, time tracking, reporting, people, meetings, documents, budgets, and other OpenProject areas.

Use cases

  • Find and update overdue work packages
  • Create project tasks and add comments
  • Bulk-edit work packages with validation
  • Inspect Git and pull-request activity
  • Upload and manage project attachments

Key features

  • Work-package search, filtering, CRUD, and bulk updates
  • Comments, watchers, reminders, reactions, and relations
  • Project and attachment management
  • Git activity and linked GitHub pull-request details
  • Structured results, validation, and conflict reporting
  • Reporting and broader OpenProject API coverage

Tools80

What OpenProject lets your agent do. Expand a tool for its parameters.

Self-reported~1.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

6/6 checks healthy over the last 34d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · openproject-mcp-server (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
Last commit8d agoMost recent push to the default branch.
Install checkRunsOur sandbox started it; it then asked for an API key or config.
Tools exposed80Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How OpenProject works

What the OpenProject MCP server does

The OpenProject MCP server exposes OpenProject API v3 operations as MCP tools. Its work-package coverage includes text search, filtered listing, detailed retrieval, creation, updates, deletion, comments, watchers, reminders, reactions, relations, custom actions, and bulk updates. Bulk changes can be previewed or applied for up to 50 items, with validation, diffs, and conflict results.

Project tools list, read, create, and update projects. Attachment tools can enumerate files, download an attachment to the machine running the server, upload a local file to supported OpenProject objects, and delete files. Other documented areas include Git activity, linked GitHub pull requests, time tracking, saved queries, notifications, versions, people, memberships, meetings, news, documents, budgets, and reporting.

How it works

The OpenProject MCP server translates MCP tool calls into requests to an OpenProject instance. Errors use a structured envelope containing an error type, upstream HTTP status, message, and correction hint.

Behavior adapts to the target OpenProject installation. The server detects API differences through a cached feature probe, and reports unavailable modules or inaccessible data as notes instead of treating those cases as successful operations. Destructive operations require a confirmation guard, and the server supports a read-only mode plus configurable tool disabling by group.

Setup and configuration

Install the Python package with uvx openproject-mcp-server, uv tool install openproject-mcp-server, or pip install openproject-mcp-server. The project requires Python 3.12 or newer. Configure the OpenProject MCP server with these environment variables:

  • OPENPROJECT_URL: The base URL of the OpenProject instance.
  • OPENPROJECT_API_KEY: An API token created under OpenProject's My account → Access tokens page.

Run openproject-mcp-server --check to validate configuration without contacting the instance. For a live connection test after adding it to a client, use the documented get_instance_info tool. Claude Code can register the service with claude mcp add; Claude Desktop and other clients use their equivalent mcpServers configuration with the command and environment values.

Tools and capabilities

The listed tools support common project-management workflows:

  • Find, filter, inspect, create, edit, bulk-update, and delete work packages.
  • Read and modify comments, watchers, reminders, reactions, and work-package relations.
  • Upload, download, list, link, and remove attachments.
  • Inspect commits, pull or merge requests, and CI status associated with work packages.
  • List, inspect, create, and update projects.
  • Generate reports and access additional documented areas such as time, people, meetings, documents, budgets, and notifications.

Limitations and notes

The OpenProject MCP server targets OpenProject 14 LTS through 17.x and requires API v3 access. Available results depend on the OpenProject version, enabled modules, and the authenticated user's permissions.

Enterprise editions may include their own built-in MCP integration, so this project is most relevant when an external MCP service is needed for a Community instance. TLS verification remains enabled, and credentials are not written to logs. Deleting work packages or attachments is permanent, so clients should handle confirmation requirements carefully.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about OpenProject

OpenProject is an MCP server that connects AI clients to the OpenProject API v3. Its tools manage work packages, comments, relations, attachments, projects, Git and pull-request activity, time, reporting, and other OpenProject data. It targets self-hosted Community instances but can connect to any edition exposing the public API.

Install it with `uvx openproject-mcp-server`, `uv tool install openproject-mcp-server`, or `pip install openproject-mcp-server`. Add `OPENPROJECT_URL` and `OPENPROJECT_API_KEY` to the client configuration, then use `openproject-mcp-server --check` to validate the settings.

It requires `OPENPROJECT_URL` and `OPENPROJECT_API_KEY`. The URL identifies the OpenProject instance, while the API key comes from **My account → Access tokens** in OpenProject. The server reads these values from the environment when it starts.

It targets OpenProject 14 LTS through 17.x and uses API v3. The server detects some version differences at runtime. Actual results can still vary with the installed modules and the permissions assigned to the API-token owner.

Yes. It is aimed at self-hosted Community edition instances and only requires access to the public OpenProject API v3.

Related MCP servers

All in Product Management All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOpenProject AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/openproject?style=directory)](https://allmcps.com/mcp/openproject)
HTML Embed
<a href="https://allmcps.com/mcp/openproject"><img src="https://allmcps.com/api/badge/openproject?style=directory" alt="OpenProject on AllMCPs" /></a>