delete_note
Remove a note from LunaTask by specifying its unique ID. This action permanently deletes the note and returns confirmation with deletion timestamp.
Instructions
Delete a note in LunaTask by note_id. Requires note_id (UUID). Returns success status with note_id and deleted_at timestamp. Note: deletion is not idempotent - second delete will return not found error.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/lunatask_mcp/tools/notes.py:179-225 (handler)The delete_note_tool method in the NotesTools class, which handles the core logic for deleting a note by calling the LunaTask client.
async def delete_note_tool( self, ctx: ServerContext, note_id: str, ) -> dict[str, Any]: """Delete a note in LunaTask. Args: ctx: Server context for logging and communication note_id: ID of the note to delete (UUID format) Returns: Dictionary with success status, note_id, deleted_at timestamp, and message. """ # Strip whitespace once at the beginning note_id = note_id.strip() await ctx.info(f"Deleting note {note_id}") # Validate note ID before making API call if not note_id: message = "Note ID cannot be empty" await ctx.error(message) logger.warning("Empty note ID provided for note deletion") return { "success": False, "error": "validation_error", "message": message, } try: async with self.lunatask_client as client: note_response = await client.delete_note(note_id) except Exception as error: return await self._handle_lunatask_api_errors(ctx, error, "note deletion") await ctx.info(f"Successfully deleted note {note_response.id}") logger.info("Successfully deleted note %s", note_response.id) return { "success": True, "note_id": note_response.id, "deleted_at": note_response.deleted_at.isoformat() if note_response.deleted_at else None, "message": "Note deleted successfully", } - src/lunatask_mcp/tools/notes.py:362-375 (registration)The registration of the delete_note tool using the FastMCP decorator inside the _register_tools method.
async def _delete_note( ctx: ServerContext, note_id: str, ) -> dict[str, Any]: return await self.delete_note_tool(ctx, note_id) self.mcp.tool( name="delete_note", description=( "Delete a note in LunaTask by note_id. Requires note_id (UUID). " "Returns success status with note_id and deleted_at timestamp. " "Note: deletion is not idempotent - second delete will return not found error." ), )(_delete_note)