delete_project_item
Remove an item from a GitHub Project V2 by specifying the owner, project number, and item ID to clean up project boards and maintain organized workflows.
Instructions
Delete an item from a GitHub Project V2.
Args:
owner: The GitHub organization or user name
project_number: The project number
item_id: The ID of the item to delete
Returns:
A confirmation message
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | Yes | ||
| project_number | Yes | ||
| item_id | Yes |
Implementation Reference
- MCP tool handler for 'delete_project_item'. Registers the tool via @mcp.tool(), handles input parameters, calls GitHubClient helper, and formats response.@mcp.tool() async def delete_project_item(owner: str, project_number: int, item_id: str) -> str: """Delete an item from a GitHub Project V2. Args: owner: The GitHub organization or user name project_number: The project number item_id: The ID of the item to delete Returns: A confirmation message """ try: deleted_item_id = await github_client.delete_project_item( owner, project_number, item_id ) return ( f"Successfully deleted item from project #{project_number}!\n" f"Deleted Item ID: {deleted_item_id}" ) except GitHubClientError as e: logger.error( f"Error deleting item {item_id} from project {project_number}: {e}" ) return f"Error: Could not delete item. Details: {e}"
- Core implementation in GitHubClient: resolves project ID, executes GraphQL deleteProjectV2Item mutation, returns deleted item ID.async def delete_project_item( self, owner: str, project_number: int, item_id: str ) -> str: """Delete an item from a GitHub Project V2. Args: owner: The GitHub organization or user name that owns the project project_number: The project number item_id: The project item ID Returns: The ID of the deleted item. Raises: GitHubClientError: If project not found or deletion fails. """ # Get project ID try: project_id = await self.get_project_node_id(owner, project_number) except GitHubClientError as e: logger.error(f"Cannot delete item: {e}") raise # Delete item delete_query = """ mutation DeleteProjectItem($projectId: ID!, $itemId: ID!) { deleteProjectV2Item(input: { projectId: $projectId, itemId: $itemId }) { deletedItemId } } """ variables = {"projectId": project_id, "itemId": item_id} try: result = await self.execute_query(delete_query, variables) if not result.get("deleteProjectV2Item") or not result[ "deleteProjectV2Item" ].get("deletedItemId"): raise GitHubClientError(f"Failed to delete item {item_id}") return result["deleteProjectV2Item"]["deletedItemId"] except GitHubClientError as e: logger.error(f"Failed to delete item {item_id}: {e}") raise