| name | composio-gmail |
| description | Send, read, search, and manage Gmail via Composio integration. Use when working with email operations. |
Gmail Integration via Composio
This skill enables AI agents to interact with Gmail through the Composio
platform, providing comprehensive email management capabilities.
Prerequisites
- Composio Account: Sign up at composio.dev
- API Key: Set
COMPOSIO_API_KEY environment variable
- Gmail Connection: Connect your Gmail account via Composio dashboard
- Enable in Config: Add to
nachos.toml:
[tools.composio]
enabled = true
api_key_env = "COMPOSIO_API_KEY"
entity_id = "default"
allowed_apps = ["gmail", ...]
Common Actions
Send Email
{
"action": "GMAIL_SEND_EMAIL",
"app": "gmail",
"params": {
"to": "recipient@example.com",
"subject": "Subject line",
"body": "Email content",
"is_html": false
}
}
Search Emails
{
"action": "GMAIL_FETCH_EMAILS",
"app": "gmail",
"params": {
"query": "from:sender@example.com subject:important",
"max_results": 10
}
}
Available Actions
- GMAIL_SEND_EMAIL - Send a new email
- GMAIL_FETCH_EMAILS - Search and fetch emails
- GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID - Get specific message
- GMAIL_CREATE_EMAIL_DRAFT - Create draft email
- GMAIL_SEND_DRAFT - Send existing draft
- GMAIL_LIST_GMAIL_LABELS - List labels
- GMAIL_CREATE_LABEL - Create new label
- GMAIL_MODIFY_EMAIL_LABELS - Add/remove labels from message
- GMAIL_REPLY_TO_EMAIL_THREAD - Reply within thread
- GMAIL_MOVE_TO_TRASH - Move message to trash
Authentication
Gmail access uses OAuth 2.0 via Composio:
- Navigate to Composio dashboard
- Add Gmail integration
- Click "Connect" and authorize
- Composio handles token refresh automatically
See Also