Gmail Delete Message

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

DESTRUCTIVEgoogle.gmail_delete_message

• Contract tier: agent_ready
• Risk: destructive
• Catalog version: google-2026.07.12.2
• Descriptor hash: 982cb26093438da6000ce003783d3f312261c1e0503f721cdfde6d3a25f0cf77

Use this destructive Gmail tool only when the user explicitly requests permanent message deletion. It cannot be undone through this MCP. It can overwrite, send, move, remove, or permanently delete Google data. Use it only after preview and the manifest-defined confirmation; it requires per-request Google OAuth.

Request Body

{
  "jsonrpc": "2.0",
  "id": "google-gmail-delete-message-example",
  "method": "tools/call",
  "params": {
    "name": "google.gmail_delete_message",
    "arguments": {
      "message_id": "message_id_123",
      "confirm": false
    }
  }
}

Arguments Schema

{
  "type": "object",
  "title": "gmail_delete_messageArguments",
  "required": [
    "message_id"
  ],
  "properties": {
    "confirm": {
      "type": "boolean",
      "title": "Confirm",
      "default": false,
      "description": "Required true for high-risk operations when confirmation is enforced."
    },
    "message_id": {
      "type": "string",
      "title": "Message Id",
      "description": "Gmail message ID."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the local or Google provider operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bounded local navigation or Google provider result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe timing, pagination, cache, request, and truncation metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe structured error when ok is false."
    }
  },
  "description": "Google MCP normalized operation envelope.",
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "google-gmail-delete-message-example",
  "method": "tools/call",
  "params": {
    "name": "google.gmail_delete_message",
    "arguments": {
      "message_id": "message_id_123",
      "confirm": false
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "google-gmail-delete-message-example",
  "method": "tools/call",
  "params": {
    "name": "google.gmail_delete_message",
    "arguments": {
      "message_id": "message_id_123",
      "confirm": false
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "google-gmail-delete-message-example",
  "method": "tools/call",
  "params": {
    "name": "google.gmail_delete_message",
    "arguments": {
      "message_id": "message_id_123",
      "confirm": false
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool google.gmail_delete_message executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}