feat: add tools for reading work item property values

plane_mcp/tools/work_item_properties.py

@@ -3,6 +3,7 @@
 from typing import Any
 
 from fastmcp import FastMCP
+from plane.errors import HttpError
 from plane.models.enums import PropertyType, RelationType
 from plane.models.work_item_properties import (
     CreateWorkItemProperty,
@@ -274,3 +275,146 @@ def delete_work_item_property(
             type_id=type_id,
             work_item_property_id=work_item_property_id,
         )
+
+    @mcp.tool()
+    def list_work_item_property_values(
+        project_id: str,
+        work_item_id: str,
+        include_unset: bool = False,
+    ) -> list[dict[str, Any]]:
+        """
+        List custom property values currently set on a work item.
+
+        Resolves the work item's type, lists all active property definitions for
+        that type, and fetches the value (if any) for each property. Useful for
+        retrieving member-type custom fields such as ``Responsible`` or ``Review``
+        whose values do not appear in ``retrieve_work_item``.
+
+        Args:
+            project_id: UUID of the project
+            work_item_id: UUID of the work item
+            include_unset: If True, include properties without a set value
+                (``value`` will be ``None``). Default False — only properties
+                with values are returned.
+
+        Returns:
+            List of dicts, one per property. Each dict contains:
+              - ``property_id``: UUID of the property definition
+              - ``display_name``: Human-readable name (e.g. "Responsible")
+              - ``name``: Internal name (slug)
+              - ``property_type``: TEXT/DATETIME/DECIMAL/BOOLEAN/OPTION/RELATION/URL/EMAIL/FILE
+              - ``relation_type``: USER/ISSUE for RELATION properties, else None
+              - ``is_multi``: Whether the property accepts multiple values
+              - ``value``: Single value or list of values (for multi). For
+                RELATION/USER it is the user UUID(s).
+              - ``value_record_ids``: ID(s) of the underlying value records.
+
+        Notes:
+            * Returns an empty list if the work item has no type assigned.
+            * Properties marked ``is_active=False`` are skipped.
+        """
+        client, workspace_slug = get_plane_client_context()
+
+        work_item = client.work_items.retrieve(
+            workspace_slug=workspace_slug,
+            project_id=project_id,
+            work_item_id=work_item_id,
+        )
+        type_id = getattr(work_item, "type_id", None)
+        if not type_id:
+            return []
+
+        properties = client.work_item_properties.list(
+            workspace_slug=workspace_slug,
+            project_id=project_id,
+            type_id=type_id,
+        )
+
+        result: list[dict[str, Any]] = []
+        for prop in properties:
+            if not getattr(prop, "is_active", True):
+                continue
+
+            value: Any = None
+            value_record_ids: Any = None
+            try:
+                value_obj = client.work_item_properties.values.retrieve(
+                    workspace_slug=workspace_slug,
+                    project_id=project_id,
+                    work_item_id=work_item_id,
+                    property_id=prop.id,
+                )
+            except HttpError as exc:
+                if exc.status_code != 404:
+                    raise
+                value_obj = None
+
+            if value_obj is None:
+                if not include_unset:
+                    continue
+            elif isinstance(value_obj, list):
+                value = [item.value for item in value_obj]
+                value_record_ids = [item.id for item in value_obj]
+            else:
+                value = value_obj.value
+                value_record_ids = value_obj.id
+
+            result.append(
+                {
+                    "property_id": prop.id,
+                    "display_name": prop.display_name,
+                    "name": getattr(prop, "name", None),
+                    "property_type": _enum_value(prop.property_type),
+                    "relation_type": _enum_value(prop.relation_type),
+                    "is_multi": bool(getattr(prop, "is_multi", False)),
+                    "value": value,
+                    "value_record_ids": value_record_ids,
+                }
+            )
+
+        return result
+
+    @mcp.tool()
+    def retrieve_work_item_property_value(
+        project_id: str,
+        work_item_id: str,
+        property_id: str,
+    ) -> dict[str, Any] | list[dict[str, Any]] | None:
+        """
+        Retrieve the value(s) of a single custom property for a work item.
+
+        Args:
+            project_id: UUID of the project
+            work_item_id: UUID of the work item
+            property_id: UUID of the property definition
+
+        Returns:
+            For single-value properties: a dict (or ``None`` if the value is
+            not set). For multi-value properties: a list of dicts.
+            Each dict mirrors ``WorkItemPropertyValueDetail`` (id, value,
+            value_type, property_id, issue_id, created_at, updated_at, ...).
+        """
+        client, workspace_slug = get_plane_client_context()
+
+        try:
+            value_obj = client.work_item_properties.values.retrieve(
+                workspace_slug=workspace_slug,
+                project_id=project_id,
+                work_item_id=work_item_id,
+                property_id=property_id,
+            )
+        except HttpError as exc:
+            if exc.status_code == 404:
+                return None
+            raise
+
+        if isinstance(value_obj, list):
+            return [item.model_dump() for item in value_obj]
+        return value_obj.model_dump()
+
+
+def _enum_value(value: Any) -> Any:
+    """Convert an enum-like field to its plain value, leave other types alone."""
+    if value is None:
+        return None
+    return getattr(value, "value", value)