OpenProject MCP Server

Instructions

Args:
    work_package_id: Work package ID
    lock_version: Current lock version (get from work package first)
    subject: New subject/title
    description: New description in markdown
    status_id: New status ID
    priority_id: New priority ID
    assignee_id: New assignee user ID (use 0 to unassign)
    notify: Whether to send notifications (default: True)

Implementation Reference

• src/openproject_mcp/tools/work_packages.py:224-287 (handler)

  Core implementation of the update_work_package tool: constructs payload with optional fields and performs PATCH request to OpenProject API.

  async def update_work_package(
      work_package_id: int,
      lock_version: int,
      subject: str | None = None,
      description: str | None = None,
      status_id: int | None = None,
      priority_id: int | None = None,
      assignee_id: int | None = None,
      notify: bool = True,
  ) -> dict[str, Any]:
      """Update an existing work package.
  
      Args:
          work_package_id: Work package ID
          lock_version: Current lock version (get from work package first)
          subject: New subject/title
          description: New description in markdown
          status_id: New status ID
          priority_id: New priority ID
          assignee_id: New assignee user ID (use 0 to unassign)
          notify: Whether to send notifications (default: True)
  
      Returns:
          Updated work package object
      """
      client = OpenProjectClient()
  
      try:
          payload: dict[str, Any] = {
              "lockVersion": lock_version,
              "_links": {},
          }
  
          if subject is not None:
              payload["subject"] = subject
  
          if description is not None:
              payload["description"] = build_formattable(description)
  
          if status_id is not None:
              payload["_links"]["status"] = build_link(f"/api/v3/statuses/{status_id}")
  
          if priority_id is not None:
              payload["_links"]["priority"] = build_link(
                  f"/api/v3/priorities/{priority_id}"
              )
  
          if assignee_id is not None:
              if assignee_id == 0:
                  payload["_links"]["assignee"] = None
              else:
                  payload["_links"]["assignee"] = build_link(
                      f"/api/v3/users/{assignee_id}"
                  )
  
          params = {"notify": str(notify).lower()}
  
          result = await client.patch(
              f"work_packages/{work_package_id}?notify={params['notify']}", data=payload
          )
          return result
      finally:
          await client.close()

• src/openproject_mcp/server.py:59-91 (registration)

  MCP tool registration using @mcp.tool() decorator. Defines input schema via type annotations and delegates to the core handler.

  @mcp.tool()
  async def update_work_package(
      work_package_id: int,
      lock_version: int,
      subject: str | None = None,
      description: str | None = None,
      status_id: int | None = None,
      priority_id: int | None = None,
      assignee_id: int | None = None,
      notify: bool = True,
  ):
      """Update an existing work package.
  
      Args:
          work_package_id: Work package ID
          lock_version: Current lock version (get from work package first)
          subject: New subject/title
          description: New description in markdown
          status_id: New status ID
          priority_id: New priority ID
          assignee_id: New assignee user ID (use 0 to unassign)
          notify: Whether to send notifications (default: True)
      """
      return await work_packages.update_work_package(
          work_package_id=work_package_id,
          lock_version=lock_version,
          subject=subject,
          description=description,
          status_id=status_id,
          priority_id=priority_id,
          assignee_id=assignee_id,
          notify=notify,
      )