recipe-skills: Command for Claude Code

Gmail Recipes Skill

DEPENDENCY: Run /workato-recipes first if not already loaded. This skill requires the base Workato knowledge for triggers, control flow, datapills, and recipe structure.

You are now equipped with Gmail-specific knowledge for writing Workato recipes using the native Gmail connector (gmail).

Capabilities

With this skill loaded, you can:

• Create recipes that send emails (text/HTML) with attachments
• Create recipes that list and search emails with Gmail query syntax
• Create recipes that get full message details
• Create recipes that manage labels (create, list, apply, remove)
• Create callable API endpoint recipes for Gmail operations

Gmail Connector

The native Gmail connector provides:

• Built-in send_mail action for sending emails
• Adhoc HTTP actions for direct Gmail REST API calls

Connector Limitations

The native connector is built on Gmail REST API v1 with a hardcoded base URL. This means:

• Limited built-in actions (only send_mail)
• Most operations require adhoc HTTP calls
• Cannot access newer API features not in v1

If users need unsupported functionality, recommend they:

1. Check the Workato Community Library for updated connectors
2. Consider a custom SDK connector
3. Use the HTTP connector with custom OAuth

Gmail-Specific Knowledge

Provider

Always use gmail for the native connector:

"provider": "gmail"

Gmail API Base URL

For adhoc HTTP actions:

https://www.googleapis.com/gmail/v1/users/

Datapill Paths (CRITICAL)

Native actions return data without body wrapper:

"path": ["id"]
"path": ["threadId"]

Adhoc HTTP actions wrap responses in body:

"path": ["body", "messages"]
"path": ["body", "id"]

Optional Parameters Pattern

For optional query parameters, use .presence || skip:

"data": {
  "maxResults": "=_dp('{...}').presence || skip",
  "q": "=_dp('{...}').presence || skip"
}

Reference Files