delete_message
Permanently delete a Gmail message by its ID to remove unwanted emails and manage inbox content.
Instructions
Immediately and permanently delete a message
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the message to delete |
Implementation Reference
- src/index.ts:567-572 (handler)Handler function for the delete_message tool. It uses the shared handleTool wrapper to authenticate and call the Gmail API's users.messages.delete method with the provided message ID.
async (params) => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.messages.delete({ userId: 'me', id: params.id }) return formatResponse(data) }) } - src/index.ts:564-566 (schema)Input schema for delete_message tool, defining the required 'id' parameter as a string.
{ id: z.string().describe("The ID of the message to delete") }, - src/index.ts:562-573 (registration)Registration of the delete_message tool on the MCP server, specifying name, description, input schema, and handler function.
server.tool("delete_message", "Immediately and permanently delete a message", { id: z.string().describe("The ID of the message to delete") }, async (params) => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.messages.delete({ userId: 'me', id: params.id }) return formatResponse(data) }) } )