delete_work_item
Remove a work item from a project by providing its UUID and the project's UUID. Use this to delete unwanted tasks or issues.
Instructions
Delete a work item by ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | UUID of the project | |
| work_item_id | Yes | UUID of the work item |
Implementation Reference
- plane_mcp/tools/work_items.py:432-443 (handler)The delete_work_item MCP tool handler function. It calls client.work_items.delete() to delete a work item by project_id and work_item_id.
@mcp.tool() def delete_work_item(project_id: str, work_item_id: str) -> None: """ Delete a work item by ID. Args: workspace_slug: The workspace slug identifier project_id: UUID of the project work_item_id: UUID of the work item """ client, workspace_slug = get_plane_client_context() client.work_items.delete(workspace_slug=workspace_slug, project_id=project_id, work_item_id=work_item_id) - plane_mcp/tools/work_items.py:64-64 (registration)The register_work_item_tools function which registers all work item tools (including delete_work_item) with the MCP server via @mcp.tool() decorator.
def register_work_item_tools(mcp: FastMCP) -> None: - plane_mcp/tools/__init__.py:22-30 (registration)Import and call of register_work_item_tools(mcp) in the main tool registration orchestrator.
from plane_mcp.tools.work_items import register_work_item_tools from plane_mcp.tools.work_logs import register_work_log_tools from plane_mcp.tools.workspaces import register_workspace_tools def register_tools(mcp: FastMCP) -> None: """Register all tools with the MCP server.""" register_project_tools(mcp) register_work_item_tools(mcp) - plane_mcp/tools/work_items.py:19-19 (helper)Import of get_plane_client_context helper used by the handler to retrieve the Plane API client and workspace slug.
from plane_mcp.client import get_plane_client_context - The inline type annotation (project_id: str, work_item_id: str) serves as the input schema for this tool. Returns None.
@mcp.tool() def delete_work_item(project_id: str, work_item_id: str) -> None: """ Delete a work item by ID. Args: workspace_slug: The workspace slug identifier project_id: UUID of the project work_item_id: UUID of the work item """ client, workspace_slug = get_plane_client_context() client.work_items.delete(workspace_slug=workspace_slug, project_id=project_id, work_item_id=work_item_id)