Gmail Skill#

Overview#

Integrate with Gmail to send/receive emails, manage threads and labels, and work with drafts. Uses official Gmail API with OAuth 2.0 authentication.

Configuration#

Set these environment variables:

VariableDescriptionGMAIL_CLIENT_IDGoogle Cloud OAuth client IDGMAIL_CLIENT_SECRETGoogle Cloud OAuth client secretGMAIL_REFRESH_TOKENOAuth refresh token for your Gmail account

Usage Examples#

Send an email#

json

{
  "tool": "gmail_send",
  "parameters": {
    "to": "recipient@example.com",
    "subject": "Meeting Reminder",
    "body": "Hi there,\n\nJust a reminder about our meeting tomorrow at 10 AM.\n\nBest regards,\nYour AI Assistant",
    "cc": ["cc@example.com"],
    "attachments": ["/workspace/documents/agenda.pdf"]
  }
}

Search for emails#

json

{
  "tool": "gmail_search",
  "parameters": {
    "query": "is:unread subject:invoice after:2026-03-01",
    "max_results": 10,
    "include_body": false
  }
}

Get email details#

json

{
  "tool": "gmail_get_message",
  "parameters": {
    "message_id": "msg_1234567890abcdef",
    "format": "full"
  }
}

List labels#

json

{
  "tool": "gmail_list_labels"
}

Modify message labels#

json

{
  "tool": "gmail_modify_labels",
  "parameters": {
    "message_id": "msg_1234567890abcdef",
    "add_labels": ["STARRED"],
    "remove_labels": ["UNREAD"]
  }
}

Query Operators#

Use these in the search query:

• is:unread - Unread messages
• is:starred - Starred messages
• from:sender@example.com - From specific sender
• to:recipient@example.com - To specific recipient
• subject:keyword - Subject contains keyword
• after:2026/01/01 - Messages after date
• before:2026/12/31 - Messages before date
• has:attachment - Messages with attachments