Gmail

Available Tools

• list_labels(): List all Gmail labels (system: INBOX, SENT, TRASH, SPAM, DRAFT, IMPORTANT, STARRED, UNREAD; plus user-created labels).

• list_emails(label?, max_results?, include_spam_trash?): List emails by label.

  • label (string, optional, default: "INBOX"): Label to filter by (INBOX, SENT, DRAFT, TRASH, SPAM, STARRED, IMPORTANT, or custom label ID)
  • max_results (integer, optional, default: 10, max: 100): Number of emails to return
  • include_spam_trash (boolean, optional, default: false): Include SPAM and TRASH

• search_emails(query, max_results?): Search Gmail using query syntax.

  • query (string, required): Gmail search query (from:, to:, subject:, is:unread, has:attachment, after:, before:, older_than:, newer_than:)
  • max_results (integer, optional, default: 10, max: 50): Number of results

• read_email(message_id): Read a full email including body and attachments.

  • message_id (string, required): Gmail message ID (from list_emails or search_emails)