OpenProject MCP Server

Instructions

Args:
    project_id: Project identifier or ID
    subject: Work package title (required)
    description: Work package description in markdown format
    type_id: Type ID (default: 1 for Task)
    status_id: Status ID (optional, uses project default if not provided)
    priority_id: Priority ID (optional, uses default if not provided)
    assignee_id: User ID to assign the work package to
    notify: Whether to send notifications (default: True)

Implementation Reference

• src/openproject_mcp/tools/work_packages.py:9-66 (handler)

  Core implementation of the create_work_package tool: constructs payload and performs POST request to OpenProject API to create the work package.

  async def create_work_package(
      project_id: str,
      subject: str,
      description: str | None = None,
      type_id: int = 1,
      status_id: int | None = None,
      priority_id: int | None = None,
      assignee_id: int | None = None,
      notify: bool = True,
  ) -> dict[str, Any]:
      """Create a new work package in a project.
  
      Args:
          project_id: Project identifier or ID
          subject: Work package title (required)
          description: Work package description in markdown format
          type_id: Type ID (default: 1 for Task)
          status_id: Status ID (optional, uses project default if not provided)
          priority_id: Priority ID (optional, uses default if not provided)
          assignee_id: User ID to assign the work package to
          notify: Whether to send notifications (default: True)
  
      Returns:
          Created work package object with ID, subject, and all properties
      """
      client = OpenProjectClient()
  
      try:
          payload: dict[str, Any] = {
              "subject": subject,
              "_links": {
                  "type": build_link(f"/api/v3/types/{type_id}"),
              },
          }
  
          if description:
              payload["description"] = build_formattable(description)
  
          if status_id:
              payload["_links"]["status"] = build_link(f"/api/v3/statuses/{status_id}")
  
          if priority_id:
              payload["_links"]["priority"] = build_link(
                  f"/api/v3/priorities/{priority_id}"
              )
  
          if assignee_id:
              payload["_links"]["assignee"] = build_link(f"/api/v3/users/{assignee_id}")
  
          params = {"notify": str(notify).lower()}
  
          result = await client.post(
              f"projects/{project_id}/work_packages", data=payload
          )
          return result
      finally:
          await client.close()

• src/openproject_mcp/server.py:14-46 (registration)

  Registers the create_work_package tool with the MCP server using @mcp.tool() decorator. Delegates execution to the implementation in work_packages module.

  @mcp.tool()
  async def create_work_package(
      project_id: str,
      subject: str,
      description: str | None = None,
      type_id: int = 1,
      status_id: int | None = None,
      priority_id: int | None = None,
      assignee_id: int | None = None,
      notify: bool = True,
  ):
      """Create a new work package in a project.
  
      Args:
          project_id: Project identifier or ID
          subject: Work package title (required)
          description: Work package description in markdown format
          type_id: Type ID (default: 1 for Task)
          status_id: Status ID (optional, uses project default if not provided)
          priority_id: Priority ID (optional, uses default if not provided)
          assignee_id: User ID to assign the work package to
          notify: Whether to send notifications (default: True)
      """
      return await work_packages.create_work_package(
          project_id=project_id,
          subject=subject,
          description=description,
          type_id=type_id,
          status_id=status_id,
          priority_id=priority_id,
          assignee_id=assignee_id,
          notify=notify,
      )