Gmail (tc)

Read, send, and manage Gmail emails, threads, labels, and drafts via Gmail API

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:

Variable	Description
GMAIL_CLIENT_ID	Google Cloud OAuth client ID
GMAIL_CLIENT_SECRET	Google Cloud OAuth client secret
GMAIL_REFRESH_TOKEN	OAuth refresh token for your Gmail account

Usage Examples

Send an email

json

{
  "tool": "gmail_send",
  "parameters": {
    "to": "[e-mail]",
    "subject": "Meeting Reminder",
    "body": "Hi there,\n\nJust a reminder about our meeting tomorrow at 10 AM.\n\nBest regards,\nYour AI Assistant",
    "cc": ["[e-mail]"],
    "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:[e-mail] - From specific sender
• to:[e-mail] - 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