@commandable/integration-data 0.0.5 → 0.0.7

package/integrations/google-gmail/handlers/create_draft_email.js

@@ -0,0 +1,27 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const lines = []
+  if (input.to) lines.push(`To: ${input.to}`)
+  lines.push(`Subject: ${input.subject || ''}`)
+  if (input.cc) lines.push(`Cc: ${input.cc}`)
+  if (input.bcc) lines.push(`Bcc: ${input.bcc}`)
+  if (input.replyToMessageId) lines.push(`In-Reply-To: ${input.replyToMessageId}`)
+  lines.push('MIME-Version: 1.0')
+  if (input.htmlBody) {
+    lines.push('Content-Type: text/html; charset=UTF-8')
+    lines.push('', input.htmlBody)
+  }
+  else {
+    lines.push('Content-Type: text/plain; charset=UTF-8')
+    lines.push('', input.body || '')
+  }
+  const raw = btoa(unescape(encodeURIComponent(lines.join('\r\n')))).replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '')
+  const message = { raw }
+  if (input.threadId) message.threadId = input.threadId
+
+  const res = await integration.fetch(`/users/${userId}/drafts`, {
+    method: 'POST',
+    body: { message },
+  })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/create_label.js

@@ -0,0 +1,12 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const body = { name: input.name }
+  if (input.messageListVisibility)
+    body.messageListVisibility = input.messageListVisibility
+  if (input.labelListVisibility)
+    body.labelListVisibility = input.labelListVisibility
+  if (input.color)
+    body.color = input.color
+  const res = await integration.fetch(`/users/${userId}/labels`, { method: 'POST', body })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/delete_draft.js

@@ -0,0 +1,13 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const draftId = encodeURIComponent(input.draftId)
+  const res = await integration.fetch(`/users/${userId}/drafts/${draftId}`, { method: 'DELETE' })
+  if (res.status === 204)
+    return { success: true }
+  try {
+    return await res.json()
+  }
+  catch {
+    return { success: true }
+  }
+}

package/integrations/google-gmail/handlers/delete_label.js

@@ -0,0 +1,13 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const labelId = encodeURIComponent(input.labelId)
+  const res = await integration.fetch(`/users/${userId}/labels/${labelId}`, { method: 'DELETE' })
+  if (res.status === 204)
+    return { success: true }
+  try {
+    return await res.json()
+  }
+  catch {
+    return { success: true }
+  }
+}

package/integrations/google-gmail/handlers/delete_message.js

@@ -0,0 +1,13 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const messageId = encodeURIComponent(input.messageId)
+  const res = await integration.fetch(`/users/${userId}/messages/${messageId}`, { method: 'DELETE' })
+  if (res.status === 204)
+    return { success: true }
+  try {
+    return await res.json()
+  }
+  catch {
+    return { success: true }
+  }
+}

package/integrations/google-gmail/handlers/delete_thread.js

@@ -0,0 +1,13 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const threadId = encodeURIComponent(input.threadId)
+  const res = await integration.fetch(`/users/${userId}/threads/${threadId}`, { method: 'DELETE' })
+  if (res.status === 204)
+    return { success: true }
+  try {
+    return await res.json()
+  }
+  catch {
+    return { success: true }
+  }
+}

package/integrations/google-gmail/handlers/get_draft.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const draftId = encodeURIComponent(input.draftId)
+  const res = await integration.fetch(`/users/${userId}/drafts/${draftId}`)
+  return await res.json()
+}

package/integrations/google-gmail/handlers/get_label.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const labelId = encodeURIComponent(input.labelId)
+  const res = await integration.fetch(`/users/${userId}/labels/${labelId}`)
+  return await res.json()
+}

package/integrations/google-gmail/handlers/get_message.js

@@ -0,0 +1,14 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const messageId = encodeURIComponent(input.messageId)
+  const params = new URLSearchParams()
+  if (input.format)
+    params.set('format', input.format)
+  if (Array.isArray(input.metadataHeaders)) {
+    for (const header of input.metadataHeaders)
+      params.append('metadataHeaders', String(header))
+  }
+  const qs = params.toString()
+  const res = await integration.fetch(`/users/${userId}/messages/${messageId}${qs ? `?${qs}` : ''}`)
+  return await res.json()
+}

package/integrations/google-gmail/handlers/get_profile.js

@@ -0,0 +1,5 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const res = await integration.fetch(`/users/${userId}/profile`)
+  return await res.json()
+}

package/integrations/google-gmail/handlers/get_thread.js

@@ -0,0 +1,14 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const threadId = encodeURIComponent(input.threadId)
+  const params = new URLSearchParams()
+  if (input.format)
+    params.set('format', input.format)
+  if (Array.isArray(input.metadataHeaders)) {
+    for (const header of input.metadataHeaders)
+      params.append('metadataHeaders', String(header))
+  }
+  const qs = params.toString()
+  const res = await integration.fetch(`/users/${userId}/threads/${threadId}${qs ? `?${qs}` : ''}`)
+  return await res.json()
+}

package/integrations/google-gmail/handlers/list_drafts.js

@@ -0,0 +1,15 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const params = new URLSearchParams()
+  if (input.q)
+    params.set('q', input.q)
+  if (input.maxResults !== undefined)
+    params.set('maxResults', String(input.maxResults))
+  if (input.pageToken)
+    params.set('pageToken', input.pageToken)
+  if (input.includeSpamTrash !== undefined)
+    params.set('includeSpamTrash', String(input.includeSpamTrash))
+  const qs = params.toString()
+  const res = await integration.fetch(`/users/${userId}/drafts${qs ? `?${qs}` : ''}`)
+  return await res.json()
+}

package/integrations/google-gmail/handlers/list_labels.js

@@ -0,0 +1,5 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const res = await integration.fetch(`/users/${userId}/labels`)
+  return await res.json()
+}

package/integrations/google-gmail/handlers/list_messages.js

@@ -0,0 +1,19 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const params = new URLSearchParams()
+  if (input.q)
+    params.set('q', input.q)
+  if (Array.isArray(input.labelIds)) {
+    for (const labelId of input.labelIds)
+      params.append('labelIds', String(labelId))
+  }
+  if (input.maxResults !== undefined)
+    params.set('maxResults', String(input.maxResults))
+  if (input.pageToken)
+    params.set('pageToken', input.pageToken)
+  if (input.includeSpamTrash !== undefined)
+    params.set('includeSpamTrash', String(input.includeSpamTrash))
+  const qs = params.toString()
+  const res = await integration.fetch(`/users/${userId}/messages${qs ? `?${qs}` : ''}`)
+  return await res.json()
+}

package/integrations/google-gmail/handlers/list_threads.js

@@ -0,0 +1,19 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const params = new URLSearchParams()
+  if (input.q)
+    params.set('q', input.q)
+  if (Array.isArray(input.labelIds)) {
+    for (const labelId of input.labelIds)
+      params.append('labelIds', String(labelId))
+  }
+  if (input.maxResults !== undefined)
+    params.set('maxResults', String(input.maxResults))
+  if (input.pageToken)
+    params.set('pageToken', input.pageToken)
+  if (input.includeSpamTrash !== undefined)
+    params.set('includeSpamTrash', String(input.includeSpamTrash))
+  const qs = params.toString()
+  const res = await integration.fetch(`/users/${userId}/threads${qs ? `?${qs}` : ''}`)
+  return await res.json()
+}

package/integrations/google-gmail/handlers/modify_message.js

@@ -0,0 +1,11 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const messageId = encodeURIComponent(input.messageId)
+  const body = {}
+  if (Array.isArray(input.addLabelIds))
+    body.addLabelIds = input.addLabelIds
+  if (Array.isArray(input.removeLabelIds))
+    body.removeLabelIds = input.removeLabelIds
+  const res = await integration.fetch(`/users/${userId}/messages/${messageId}/modify`, { method: 'POST', body })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/modify_thread.js

@@ -0,0 +1,11 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const threadId = encodeURIComponent(input.threadId)
+  const body = {}
+  if (Array.isArray(input.addLabelIds))
+    body.addLabelIds = input.addLabelIds
+  if (Array.isArray(input.removeLabelIds))
+    body.removeLabelIds = input.removeLabelIds
+  const res = await integration.fetch(`/users/${userId}/threads/${threadId}/modify`, { method: 'POST', body })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/read_email.js

@@ -0,0 +1,56 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const messageId = encodeURIComponent(input.messageId)
+  const res = await integration.fetch(`/users/${userId}/messages/${messageId}?format=full`)
+  const msg = await res.json()
+
+  const getHeader = (name) => {
+    const h = (msg.payload?.headers || []).find(h => h.name.toLowerCase() === name.toLowerCase())
+    return h?.value || ''
+  }
+
+  const decodeBase64url = (data) => {
+    if (!data) return ''
+    try {
+      return decodeURIComponent(escape(atob(data.replace(/-/g, '+').replace(/_/g, '/'))))
+    }
+    catch {
+      return ''
+    }
+  }
+
+  // Recursively extract text body, preferring text/plain over text/html
+  const extractBody = (part) => {
+    if (!part) return ''
+    if (part.mimeType === 'text/plain' && part.body?.data)
+      return decodeBase64url(part.body.data)
+    if (part.parts) {
+      // Depth-first: try text/plain first across all parts
+      for (const p of part.parts) {
+        if (p.mimeType === 'text/plain' && p.body?.data)
+          return decodeBase64url(p.body.data)
+      }
+      // Recurse into nested multipart
+      for (const p of part.parts) {
+        const text = extractBody(p)
+        if (text) return text
+      }
+    }
+    if (part.mimeType === 'text/html' && part.body?.data)
+      return decodeBase64url(part.body.data)
+    return ''
+  }
+
+  return {
+    id: msg.id,
+    threadId: msg.threadId,
+    labelIds: msg.labelIds || [],
+    subject: getHeader('Subject'),
+    from: getHeader('From'),
+    to: getHeader('To'),
+    cc: getHeader('Cc'),
+    date: getHeader('Date'),
+    snippet: msg.snippet || '',
+    body: extractBody(msg.payload),
+  }
+}

package/integrations/google-gmail/handlers/send_draft.js

@@ -0,0 +1,15 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const body = {}
+  if (input.draftId)
+    body.id = input.draftId
+  if (input.raw) {
+    body.message = { raw: input.raw }
+    if (input.threadId)
+      body.message.threadId = input.threadId
+    if (Array.isArray(input.labelIds))
+      body.message.labelIds = input.labelIds
+  }
+  const res = await integration.fetch(`/users/${userId}/drafts/send`, { method: 'POST', body })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/send_email.js

@@ -0,0 +1,22 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const lines = [`To: ${input.to}`, `Subject: ${input.subject}`]
+  if (input.cc) lines.push(`Cc: ${input.cc}`)
+  if (input.bcc) lines.push(`Bcc: ${input.bcc}`)
+  if (input.replyToMessageId) lines.push(`In-Reply-To: ${input.replyToMessageId}`)
+  lines.push('MIME-Version: 1.0')
+  if (input.htmlBody) {
+    lines.push('Content-Type: text/html; charset=UTF-8')
+    lines.push('', input.htmlBody)
+  }
+  else {
+    lines.push('Content-Type: text/plain; charset=UTF-8')
+    lines.push('', input.body)
+  }
+  const mime = lines.join('\r\n')
+  const raw = btoa(unescape(encodeURIComponent(mime))).replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '')
+  const body = { raw }
+  if (input.threadId) body.threadId = input.threadId
+  const res = await integration.fetch(`/users/${userId}/messages/send`, { method: 'POST', body })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/trash_message.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const messageId = encodeURIComponent(input.messageId)
+  const res = await integration.fetch(`/users/${userId}/messages/${messageId}/trash`, { method: 'POST' })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/trash_thread.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const threadId = encodeURIComponent(input.threadId)
+  const res = await integration.fetch(`/users/${userId}/threads/${threadId}/trash`, { method: 'POST' })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/untrash_message.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const messageId = encodeURIComponent(input.messageId)
+  const res = await integration.fetch(`/users/${userId}/messages/${messageId}/untrash`, { method: 'POST' })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/untrash_thread.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const threadId = encodeURIComponent(input.threadId)
+  const res = await integration.fetch(`/users/${userId}/threads/${threadId}/untrash`, { method: 'POST' })
+  return await res.json()
+}

package/integrations/google-gmail/handlers/update_label.js

@@ -0,0 +1,15 @@
+async (input) => {
+  const userId = encodeURIComponent(input.userId || 'me')
+  const labelId = encodeURIComponent(input.labelId)
+  const body = {}
+  if (input.name !== undefined)
+    body.name = input.name
+  if (input.messageListVisibility !== undefined)
+    body.messageListVisibility = input.messageListVisibility
+  if (input.labelListVisibility !== undefined)
+    body.labelListVisibility = input.labelListVisibility
+  if (input.color !== undefined)
+    body.color = input.color
+  const res = await integration.fetch(`/users/${userId}/labels/${labelId}`, { method: 'PATCH', body })
+  return await res.json()
+}

package/integrations/google-gmail/manifest.json

@@ -0,0 +1,44 @@
+{
+  "name": "google-gmail",
+  "version": "0.1.0",
+  "toolsets": {
+    "email": {
+      "label": "Email",
+      "description": "Search, read, compose, and send emails and drafts"
+    },
+    "organize": {
+      "label": "Organize",
+      "description": "Label, archive, trash, and delete messages and threads"
+    }
+  },
+  "tools": [
+    { "name": "get_profile", "description": "Get mailbox profile details for the authenticated user, including email address, messages total, threads total, and history ID. Useful for confirming the active account.", "inputSchema": "schemas/get_profile.json", "handler": "handlers/get_profile.js", "scope": "read", "toolset": "email" },
+    { "name": "list_messages", "description": "List message IDs matching a Gmail search query or label filters. Returns only IDs and threadIds, not full content -- use read_email or get_message to fetch content for specific messages. Supports Gmail query operators: 'is:unread', 'from:user@example.com', 'to:user@example.com', 'subject:keyword', 'has:attachment', 'after:2024/01/01', 'before:2024/12/31', 'newer_than:7d', 'label:INBOX', 'in:sent'. Defaults to 20 results. Use pageToken from the response for the next page.", "inputSchema": "schemas/list_messages.json", "handler": "handlers/list_messages.js", "scope": "read", "toolset": "email" },
+    { "name": "read_email", "description": "Read an email by message ID and return a flat, decoded result with subject, from, to, cc, date, snippet, body text, labelIds, and threadId. Use this for reading email content -- it handles base64 decoding and header extraction automatically. For raw API access or advanced format options, use get_message instead.", "inputSchema": "schemas/read_email.json", "handler": "handlers/read_email.js", "scope": "read", "toolset": "email" },
+    { "name": "get_message", "description": "Get the raw Gmail message resource by message ID. Returns the full nested payload including base64url-encoded body parts and all headers. For most use cases, prefer read_email which decodes the response into a flat readable format. Use format='minimal' for lightweight ID+threadId+labelIds only, format='metadata' with metadataHeaders for specific headers only.", "inputSchema": "schemas/get_message.json", "handler": "handlers/get_message.js", "scope": "read", "toolset": "email" },
+    { "name": "list_threads", "description": "List thread IDs matching a Gmail search query or label filters. Similar to list_messages but grouped by conversation thread. Returns only IDs -- use get_thread to fetch full thread content. Supports the same Gmail query operators as list_messages. Defaults to 20 results. Use pageToken from the response for the next page.", "inputSchema": "schemas/list_threads.json", "handler": "handlers/list_threads.js", "scope": "read", "toolset": "email" },
+    { "name": "get_thread", "description": "Get a full thread resource by thread ID, including all messages in the conversation. Use list_threads to find thread IDs. Use format='minimal' to get only message IDs within the thread without full content.", "inputSchema": "schemas/get_thread.json", "handler": "handlers/get_thread.js", "scope": "read", "toolset": "email" },
+    { "name": "list_drafts", "description": "List drafts in the mailbox. Returns draft IDs and the nested message ID. Use get_draft to fetch full draft content. Defaults to 20 results. Use pageToken for the next page.", "inputSchema": "schemas/list_drafts.json", "handler": "handlers/list_drafts.js", "scope": "read", "toolset": "email" },
+    { "name": "get_draft", "description": "Get a draft by draft ID. Returns the draft object including the nested message resource. Use list_drafts to find draft IDs.", "inputSchema": "schemas/id_draft.json", "handler": "handlers/get_draft.js", "scope": "read", "toolset": "email" },
+
+    { "name": "send_email", "description": "Send an email by providing flat fields: to, subject, and body. Handles MIME encoding and base64url conversion internally. For replies, provide replyToMessageId (the original message's ID) and threadId to keep the reply in the same conversation thread. Supports plain text and HTML bodies, CC, and BCC.", "inputSchema": "schemas/send_email.json", "handler": "handlers/send_email.js", "scope": "write", "toolset": "email" },
+    { "name": "create_draft_email", "description": "Create a draft email using flat fields: subject, body, and optionally to, cc, bcc. Handles MIME encoding internally. The draft is saved but not sent -- use send_draft to send it later. For replies, provide replyToMessageId and threadId. Supports plain text and HTML bodies.", "inputSchema": "schemas/create_draft_email.json", "handler": "handlers/create_draft_email.js", "scope": "write", "toolset": "email" },
+    { "name": "delete_draft", "description": "Permanently delete a draft by its draft ID. Use list_drafts to find draft IDs. This cannot be undone.", "inputSchema": "schemas/id_draft.json", "handler": "handlers/delete_draft.js", "scope": "write", "toolset": "email" },
+    { "name": "send_draft", "description": "Send an existing draft by draft ID, or send a one-off draft payload (provide raw instead of draftId). One of draftId or raw must be provided. To send a previously created draft, provide only draftId. To send a new message without saving first, use send_email instead.", "inputSchema": "schemas/send_draft.json", "handler": "handlers/send_draft.js", "scope": "write", "toolset": "email" },
+
+    { "name": "list_labels", "description": "List all labels in the user's mailbox, including system labels (INBOX, SENT, DRAFT, SPAM, TRASH, STARRED, IMPORTANT, UNREAD) and user-created labels. Returns label IDs needed for filtering in list_messages and list_threads.", "inputSchema": "schemas/list_labels.json", "handler": "handlers/list_labels.js", "scope": "read", "toolset": "organize" },
+    { "name": "get_label", "description": "Get details for a specific label by its label ID. Returns name, type, visibility settings, and message/thread counts. Use list_labels first to find the label ID.", "inputSchema": "schemas/id_label.json", "handler": "handlers/get_label.js", "scope": "read", "toolset": "organize" },
+    { "name": "modify_message", "description": "Add or remove labels on a single message. Provide addLabelIds, removeLabelIds, or both. Common label IDs: 'INBOX', 'UNREAD', 'STARRED', 'IMPORTANT', 'TRASH', 'SPAM'. To archive a message, remove 'INBOX'. To mark as read, remove 'UNREAD'. Use list_labels to find custom label IDs.", "inputSchema": "schemas/modify_message.json", "handler": "handlers/modify_message.js", "scope": "write", "toolset": "organize" },
+    { "name": "trash_message", "description": "Move a message to the Trash. The message is not permanently deleted and can be restored with untrash_message. To permanently delete, use delete_message.", "inputSchema": "schemas/id_message.json", "handler": "handlers/trash_message.js", "scope": "write", "toolset": "organize" },
+    { "name": "untrash_message", "description": "Restore a message from Trash back to the Inbox. Use list_messages with labelIds=['TRASH'] to find trashed message IDs.", "inputSchema": "schemas/id_message.json", "handler": "handlers/untrash_message.js", "scope": "write", "toolset": "organize" },
+    { "name": "delete_message", "description": "Permanently and immediately delete a message by ID. This cannot be undone. For recoverable deletion, use trash_message instead.", "inputSchema": "schemas/id_message.json", "handler": "handlers/delete_message.js", "scope": "write", "toolset": "organize" },
+    { "name": "modify_thread", "description": "Add or remove labels on all messages in a thread at once. Provide addLabelIds, removeLabelIds, or both. Common label IDs: 'INBOX', 'UNREAD', 'STARRED', 'IMPORTANT'. To archive a thread, remove 'INBOX'. Use list_labels to find custom label IDs.", "inputSchema": "schemas/modify_thread.json", "handler": "handlers/modify_thread.js", "scope": "write", "toolset": "organize" },
+    { "name": "trash_thread", "description": "Move an entire thread to Trash. All messages in the thread are trashed. Can be reversed with untrash_thread.", "inputSchema": "schemas/id_thread.json", "handler": "handlers/trash_thread.js", "scope": "write", "toolset": "organize" },
+    { "name": "untrash_thread", "description": "Restore an entire thread from Trash. Use list_threads with labelIds=['TRASH'] to find trashed thread IDs.", "inputSchema": "schemas/id_thread.json", "handler": "handlers/untrash_thread.js", "scope": "write", "toolset": "organize" },
+    { "name": "delete_thread", "description": "Permanently and immediately delete an entire thread and all its messages. This cannot be undone. For recoverable deletion, use trash_thread instead.", "inputSchema": "schemas/id_thread.json", "handler": "handlers/delete_thread.js", "scope": "write", "toolset": "organize" },
+
+    { "name": "create_label", "description": "Create a new mailbox label with optional visibility and color settings. Label names must be unique. After creating a label, use its returned ID with modify_message or modify_thread to apply it.", "inputSchema": "schemas/create_label.json", "handler": "handlers/create_label.js", "scope": "admin", "toolset": "organize" },
+    { "name": "update_label", "description": "Update (patch) an existing mailbox label's name, color, or visibility settings by label ID. Use list_labels to find label IDs.", "inputSchema": "schemas/update_label.json", "handler": "handlers/update_label.js", "scope": "admin", "toolset": "organize" },
+    { "name": "delete_label", "description": "Permanently delete a mailbox label by label ID. Messages with this label will have it removed but will not be deleted. Use list_labels to find label IDs. System labels (INBOX, SENT, etc.) cannot be deleted.", "inputSchema": "schemas/id_label.json", "handler": "handlers/delete_label.js", "scope": "admin", "toolset": "organize" }
+  ]
+}

package/integrations/google-gmail/prompt.md

@@ -0,0 +1,52 @@
+## Gmail search query syntax
+
+Gmail's `q` parameter supports a powerful search language. Key operators:
+
+- `is:unread` / `is:read` — filter by read status
+- `is:starred`, `is:important` — filter by markers
+- `from:user@example.com` — sender filter
+- `to:user@example.com`, `cc:user@example.com` — recipient filters
+- `subject:keyword` — subject line search
+- `has:attachment` — messages with attachments
+- `filename:report.pdf` — specific attachment filename
+- `label:INBOX` — filter by label (use label name or ID)
+- `after:2024/01/01`, `before:2024/12/31` — date range (YYYY/MM/DD)
+- `newer_than:7d`, `older_than:1y` — relative time (d=days, m=months, y=years)
+- `in:sent`, `in:drafts`, `in:trash`, `in:spam` — folder filters
+- `larger:5M`, `smaller:1M` — size filters
+
+Combine operators with spaces (implicit AND): `from:alice is:unread has:attachment`
+
+## Recommended workflows
+
+**Reading emails:**
+1. Use `list_messages` with a `q` query to find relevant message IDs
+2. Use `read_email` on each ID to get decoded subject, from, to, date, and body text
+3. For raw access or advanced format options, use `get_message` with `format='full'`
+
+**Searching for threads:**
+1. Use `list_threads` with `q` to find conversation threads
+2. Use `get_thread` to retrieve all messages in a conversation at once
+
+**Sending email:**
+- Use `send_email` for the vast majority of cases -- it accepts plain `to`, `subject`, `body` fields
+- Use `create_draft_email` + `send_draft` when you want to create a draft for review before sending
+
+**Replying to an email:**
+1. Get the original message with `read_email` to obtain its `threadId` and `id`
+2. Call `send_email` with `replyToMessageId` = original message `id` and `threadId` = original `threadId`
+3. The reply will appear in the same conversation thread
+
+## Label IDs
+
+System label IDs (always uppercase): `INBOX`, `UNREAD`, `STARRED`, `IMPORTANT`, `SENT`, `DRAFT`, `SPAM`, `TRASH`, `CATEGORY_PERSONAL`, `CATEGORY_SOCIAL`, `CATEGORY_PROMOTIONS`, `CATEGORY_UPDATES`, `CATEGORY_FORUMS`
+
+User-created labels have auto-generated IDs. Use `list_labels` to discover them.
+
+## Archiving and organizing
+
+- Archive a message: `modify_message` with `removeLabelIds=['INBOX']`
+- Mark as read: `modify_message` with `removeLabelIds=['UNREAD']`
+- Star a message: `modify_message` with `addLabelIds=['STARRED']`
+- Apply a label: `modify_message` with `addLabelIds=['<labelId>']`
+- Use `modify_thread` to apply the same operation to all messages in a thread at once

package/integrations/google-gmail/schemas/create_draft_email.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "userId": { "type": "string", "description": "User email or 'me'. Defaults to 'me'." },
+    "to": { "type": "string", "description": "Recipient email address. Optional for drafts." },
+    "cc": { "type": "string", "description": "CC recipients, comma-separated." },
+    "bcc": { "type": "string", "description": "BCC recipients, comma-separated." },
+    "subject": { "type": "string", "description": "Draft subject line." },
+    "body": { "type": "string", "description": "Plain text draft body. Used when htmlBody is not provided." },
+    "htmlBody": { "type": "string", "description": "HTML draft body. If provided, takes precedence over body." },
+    "replyToMessageId": { "type": "string", "description": "Message ID being replied to. Sets In-Reply-To header." },
+    "threadId": { "type": "string", "description": "Thread ID to place the draft in an existing conversation." }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/create_label.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["name"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "name": { "type": "string", "description": "Label display name." },
+    "messageListVisibility": {
+      "type": "string",
+      "enum": ["show", "hide"]
+    },
+    "labelListVisibility": {
+      "type": "string",
+      "enum": ["labelShow", "labelShowIfUnread", "labelHide"]
+    },
+    "color": {
+      "type": "object",
+      "properties": {
+        "textColor": { "type": "string", "description": "Hex color, e.g. #000000" },
+        "backgroundColor": { "type": "string", "description": "Hex color, e.g. #ffffff" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/get_message.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["messageId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "messageId": { "type": "string", "description": "Gmail message ID." },
+    "format": {
+      "type": "string",
+      "enum": ["minimal", "full", "raw", "metadata"],
+      "description": "Message format. Defaults to full."
+    },
+    "metadataHeaders": {
+      "type": "array",
+      "description": "Headers to include when format is metadata.",
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/{google-docs/schemas/get_document_structured.json → google-gmail/schemas/get_profile.json}

@@ -2,8 +2,10 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "type": "object",
   "properties": {
-    "documentId": { "type": "string" }
+    "userId": {
+      "type": "string",
+      "description": "User email address or the special value 'me'. Defaults to 'me'."
+    }
   },
-  "required": ["documentId"],
   "additionalProperties": false
 }

package/integrations/google-gmail/schemas/get_thread.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["threadId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "threadId": { "type": "string", "description": "Gmail thread ID." },
+    "format": {
+      "type": "string",
+      "enum": ["minimal", "full", "metadata"],
+      "description": "Thread message format. Defaults to full."
+    },
+    "metadataHeaders": {
+      "type": "array",
+      "description": "Headers to include when format is metadata.",
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/id_draft.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["draftId"],
+  "properties": {
+    "userId": {
+      "type": "string",
+      "description": "User email address or 'me'. Defaults to 'me'."
+    },
+    "draftId": {
+      "type": "string",
+      "description": "Gmail draft ID."
+    }
+  },
+  "additionalProperties": false
+}