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 manage 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

src/github_projects_mcp/server.py:424-450 (handler)

The primary MCP tool handler for 'delete_project_item'. Decorated with @mcp.tool() for registration. Validates inputs via type hints and docstring, delegates to GitHubClient, handles errors, 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}"

src/github_projects_mcp/github_client.py:1096-1143 (helper)

Supporting method in GitHubClient class that performs the actual GraphQL mutation to delete the project item via GitHub's API.

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

src/github_projects_mcp/server.py:424-424 (registration)
The @mcp.tool() decorator registers this function as an MCP tool.
```
@mcp.tool()
```

src/github_projects_mcp/server.py:426-435 (schema)

Docstring and type annotations define the input schema (parameters) and output for the MCP tool.

"""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
"""

github-projects-mcp