Gmail Tools

# List recent emails from a specific sender
result = await agent.read_emails(
    query="from:[email protected]",
    max_results=5
)

# List unread emails with attachments
result = await agent.read_emails(
    query="is:unread has:attachment",
    max_results=10
)

# First, list emails to get message IDs
emails = await agent.read_emails(query="from:[email protected]", max_results=1)
message_id = emails["messages"][0]["id"]

# Then get full details
result = await agent.get_email_details(message_id=message_id)
print(result["body"])  # Full email content

# Get last week's email summary
result = await agent.summarize_weekly_emails(
    days=7,
    max_results=50
)

print(f"Total emails: {result['summary']['message_count']}")
print(f"Top senders: {result['summary']['top_senders']}")

# Search for emails about a specific project
result = await agent.search_emails(
    query="subject:Q1-2026 has:attachment",
    max_results=20
)

# Search for recent important emails
result = await agent.search_emails(
    query="is:important after:2026/03/01"
)

# Check unread emails
result = await agent.list_unread_emails(max_results=20)

if result["success"]:
    unread_count = len(result["messages"])
    print(f"You have {unread_count} unread emails")

{
  "success": bool,      # Operation success status
  "message": str,       # Human-readable message
  "error": str,         # Error details (if failed)
  # Additional fields specific to each tool
}