modify_message
Add or remove labels from a specific Gmail message using its ID. Streamline email organization by updating label assignments directly through Gmail MCP.
Instructions
Modify the labels on a message
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| addLabelIds | No | A list of label IDs to add to the message | |
| id | Yes | The ID of the message to modify | |
| removeLabelIds | No | A list of label IDs to remove from the message |
Implementation Reference
- src/index.ts:625-638 (registration)Registration of the 'modify_message' tool, including description, input schema, and inline handler function.
server.tool("modify_message", "Modify the labels on a message", { id: z.string().describe("The ID of the message to modify"), addLabelIds: z.array(z.string()).optional().describe("A list of label IDs to add to the message"), removeLabelIds: z.array(z.string()).optional().describe("A list of label IDs to remove from the message") }, async (params) => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.messages.modify({ userId: 'me', id: params.id, requestBody: { addLabelIds: params.addLabelIds, removeLabelIds: params.removeLabelIds } }) return formatResponse(data) }) } ) - src/index.ts:632-637 (handler)Handler function that executes the tool logic: calls handleTool wrapper which authenticates and invokes Gmail API users.messages.modify to update labels on a specific message.
async (params) => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.messages.modify({ userId: 'me', id: params.id, requestBody: { addLabelIds: params.addLabelIds, removeLabelIds: params.removeLabelIds } }) return formatResponse(data) }) } - src/index.ts:628-631 (schema)Zod schema defining input parameters for the modify_message tool: message ID (required), optional label IDs to add or remove.
id: z.string().describe("The ID of the message to modify"), addLabelIds: z.array(z.string()).optional().describe("A list of label IDs to add to the message"), removeLabelIds: z.array(z.string()).optional().describe("A list of label IDs to remove from the message") },