delete_label
Remove a specific Gmail label using its label ID. Streamline your email organization by cleaning up unused or redundant labels.
Instructions
Delete a Gmail label
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| labelId | Yes | Label ID to delete |
Implementation Reference
- src/tools.ts:15-15 (schema)Input schema definition for delete_label tool - requires a labelId string parameter.
delete_label: z.object({ labelId: z.string().describe("Label ID to delete") }), - src/tools.ts:42-42 (registration)Description registered for the delete_label tool: 'Delete a Gmail label'.
delete_label: "Delete a Gmail label", - src/tools.ts:108-112 (handler)Tool handler case for delete_label - validates input via Zod schema, calls gmailService.deleteLabel(v.labelId), and returns a success message.
case "delete_label": { const v = validated as z.infer<typeof schemas.delete_label>; await gmailService.deleteLabel(v.labelId); return { content: [{ type: "text", text: `Label ${v.labelId} deleted successfully.` }] }; } - src/gmail-service.ts:93-95 (helper)GmailService.deleteLabel() method - executes the Gmail API call to delete a label by ID via users.labels.delete.
async deleteLabel(id: string): Promise<void> { await this.gmail.users.labels.delete({ userId: 'me', id }); } - src/lib.ts:48-48 (registration)The tool is registered as an MCP tool via getToolDefinitions() called in the ListToolsRequestSchema handler.
server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: getToolDefinitions() }));