Gmail

The Gmail integration lets agents send emails, read messages, search inboxes, and manage labels.

Setup

skillett connect gmail

Skillett handles all authentication automatically when you connect.

Endpoints

Endpoint	Method	Description
list_messages	GET	List messages in the inbox
get_message	GET	Get a specific message
send_message	POST	Send an email
reply_to_message	POST	Reply to a message
search_messages	GET	Search messages with Gmail query syntax
list_labels	GET	List all labels
create_label	POST	Create a label
modify_labels	POST	Add/remove labels on a message
trash_message	POST	Move a message to trash
untrash_message	POST	Remove a message from trash
list_threads	GET	List conversation threads
get_thread	GET	Get a conversation thread

Example usage

# Search for unread messages
skillett run gmail search_messages --q "is:unread from:team@example.com"

# Send an email
skillett run gmail send_message --to "user@example.com" --subject "Hello" --body "Message body"

# List recent messages
skillett run gmail list_messages --maxResults 10

Common patterns

• Search syntax: Uses Gmail’s native query syntax (is:unread, from:, subject:, has:attachment, etc.)
• Message IDs: Gmail uses opaque string IDs for messages and threads
• Labels: Messages can have multiple labels (INBOX, UNREAD, custom labels)