unassign_task_from_user

Remove user assignments from specific tasks in the Taiga project management platform. Facilitates task management by clearing assigned users when needed.

Instructions

Unassigns a specific task (sets assigned user to null).

Input Schema

TableJSON Schema

Name	Required	Description	Default
`session_id`	Yes
`task_id`	Yes

Implementation Reference

src/server.py:587-594 (handler)

The primary handler function for the 'unassign_task_from_user' MCP tool. It delegates to the general 'update_task' function by passing assigned_to=None to unassign the task from any user.

@mcp.tool("unassign_task_from_user", description="Unassigns a specific task (sets assigned user to null).")
def unassign_task_from_user(session_id: str, task_id: int) -> Dict[str, Any]:
    """Unassigns a task."""
    logger.info(
        f"Executing unassign_task_from_user: Task {task_id}, session {session_id[:8]}...")
    # Delegate to update_task
    return update_task(session_id, task_id, assigned_to=None)

src/server.py:522-555 (helper)

Supporting helper function 'update_task' that performs the actual Taiga API edit call on tasks. This is invoked by 'unassign_task_from_user' to set the assigned_to field to None.

def update_task(session_id: str, task_id: int, **kwargs) -> Dict[str, Any]:
    """Updates a task. Pass fields to update as keyword arguments (e.g., subject, description, status_id, assigned_to)."""
    logger.info(
        f"Executing update_task ID {task_id} for session {session_id[:8]} with data: {kwargs}")
    taiga_client_wrapper = _get_authenticated_client(session_id) # Use wrapper variable name
    try:
        # Use pytaigaclient edit pattern for partial updates
        if not kwargs:
             logger.info(f"No fields provided for update on task {task_id}")
             return taiga_client_wrapper.api.tasks.get(task_id)

        # Get current task data to retrieve version
        current_task = taiga_client_wrapper.api.tasks.get(task_id)
        version = current_task.get('version')
        if not version:
            raise ValueError(f"Could not determine version for task {task_id}")
            
        # Use edit method for partial updates with keyword arguments
        updated_task = taiga_client_wrapper.api.tasks.edit(
            task_id=task_id,
            version=version,
            **kwargs
        )
        logger.info(f"Task {task_id} update request sent.")
        return updated_task
    except TaigaException as e:
        logger.error(
            f"Taiga API error updating task {task_id}: {e}", exc_info=False)
        raise e
    except Exception as e:
        logger.error(
            f"Unexpected error updating task {task_id}: {e}", exc_info=True)
        raise RuntimeError(f"Server error updating task: {e}")

src/server.py:39-52 (helper)

Helper function to retrieve and validate the authenticated Taiga client wrapper for the given session_id, used by all authenticated tools including update_task.

def _get_authenticated_client(session_id: str) -> TaigaClientWrapper:
    """
    Retrieves the authenticated TaigaClientWrapper for a given session ID.
    Raises PermissionError if the session is invalid or not found.
    """
    client = active_sessions.get(session_id)
    # Also check if the client object itself exists and is authenticated
    if not client or not client.is_authenticated:
        logger.warning(f"Invalid or expired session ID provided: {session_id}")
        # Raise PermissionError - FastMCP will map this to an appropriate error response
        raise PermissionError(
            f"Invalid or expired session ID: '{session_id}'. Please login again.")
    logger.debug(f"Retrieved valid client for session ID: {session_id}")
    return client

Taiga MCP Bridge