delete_filter
Remove unwanted email filters from your Gmail account by specifying the filter ID to delete. This tool helps manage your inbox organization by eliminating outdated or unnecessary filtering rules.
Instructions
Deletes a filter
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the filter to be deleted |
Implementation Reference
- src/index.ts:1026-1037 (registration)Registration of the 'delete_filter' MCP tool. Includes input schema (filter ID), description, and inline handler function that uses handleTool to authenticate and call Gmail API to delete the specified filter.
server.tool("delete_filter", "Deletes a filter", { id: z.string().describe("The ID of the filter to be deleted") }, async (params) => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.settings.filters.delete({ userId: 'me', id: params.id }) return formatResponse(data) }) } ) - src/index.ts:1031-1037 (handler)Handler function for delete_filter tool. Takes params, uses shared handleTool to validate OAuth2 credentials, create Gmail client, delete filter by ID via Gmail API, and format response.
async (params) => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.settings.filters.delete({ userId: 'me', id: params.id }) return formatResponse(data) }) } ) - src/index.ts:1029-1030 (schema)Input schema for delete_filter tool using Zod: requires 'id' string (Gmail filter ID).
id: z.string().describe("The ID of the filter to be deleted") }, - src/index.ts:50-66 (helper)Shared helper function handleTool used by delete_filter and other tools for OAuth2 authentication, Gmail client creation, API call execution, and error handling.
const handleTool = async (queryConfig: Record<string, any> | undefined, apiCall: (gmail: gmail_v1.Gmail) => Promise<any>) => { try { const oauth2Client = queryConfig ? createOAuth2Client(queryConfig) : defaultOAuth2Client if (!oauth2Client) throw new Error('OAuth2 client could not be created, please check your credentials') const credentialsAreValid = await validateCredentials(oauth2Client) if (!credentialsAreValid) throw new Error('OAuth2 credentials are invalid, please re-authenticate') const gmailClient = queryConfig ? google.gmail({ version: 'v1', auth: oauth2Client }) : defaultGmailClient if (!gmailClient) throw new Error('Gmail client could not be created, please check your credentials') const result = await apiCall(gmailClient) return result } catch (error: any) { return `Tool execution failed: ${error.message}` } } - src/index.ts:48-49 (helper)Shared helper to format API responses as MCP content blocks with JSON stringified data.
const formatResponse = (response: any) => ({ content: [{ type: "text", text: JSON.stringify(response) }] })