composio-gmail
This skill provides a verified toolkit for automating Gmail operations through Composio, including sending, reading, searching, drafting, and thread management. It documents all key tool slugs, argument shapes, and practical recipes for metadata-first reads and HTML email sends.
Composio-gmail lets you send and manage Gmail emails programmatically using verified Composio toolkit tools.
AI-generated summary based on this skill's SKILL.md
Install
desplega-ai/agent-swarm/composio-gmail · repository language: TypeScript
git clone https://github.com/desplega-ai/agent-swarm
cp -r agent-swarm/plugin/skills/composio-gmail ~/.claude/skills/composio-gmailnpx skillfed install desplega-ai/agent-swarm/composio-gmailFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I send email with Gmail Composio?
composio-gmail enables programmatic email sending through the GMAIL_SEND_EMAIL tool. Configure your Composio Gmail toolkit with authenticated credentials, then invoke the send action with recipient, subject, and body parameters. The skill documents the complete argument schema and includes recipes for both plain-text and HTML email composition.
What is the composio Gmail toolkit integration process?
composio-gmail provides a verified toolkit that integrates Gmail operations into Composio agent workflows. Set up a connected account via Composio's authentication layer, then access tool slugs for sending, fetching, searching, drafting, and managing threads. The skill includes configuration guidance and practical playbook examples for agent-driven automation.
How can I fetch and search emails using composio Gmail?
composio-gmail documents tools for fetching Gmail messages with search and read capabilities. Use the message fetch tools with query syntax parameters to filter by sender, subject, date, or labels. The skill provides query syntax examples and explains the max_results parameter for controlling batch sizes in agent workflows.
How do I manage Gmail threads, drafts, and labels with composio?
composio-gmail includes tools for thread management, draft creation, label operations, and contact handling. Reply to threads, create drafts, apply or remove labels, and access contact metadata through dedicated tool slugs. The skill documents argument shapes and includes playbook recipes for multi-step label and thread workflows.
Can composio-gmail download attachments and retrieve profile data?
composio-gmail supports attachment downloads and Gmail profile metadata retrieval. Access mailbox information, user profile details, and attachment content through documented tool actions. The skill explains metadata-first read patterns and provides examples for extracting profile and attachment data in agent automation sequences.
What tools are available in the composio Gmail API toolkit?
composio-gmail documents all key tool slugs including GMAIL_SEND_EMAIL, message fetch, search, thread reply, draft creation, label management, contact access, attachment download, and profile retrieval. Each tool includes argument documentation, return schemas, and usage context. The skill is licensed under MIT and provides complete integration guidance for Composio workflows.
SKILL.md
rendered from the published skill — quoted content, verbatim
Composio · Gmail
Toolkit slug: gmail. Read the [[composio]] hub first for the call model
(agent-swarm x composio …, user_id, connected accounts, the 4302 gotcha).
Tool arguments go inside the request body; user_id defaults to "me" (the
authorized account) — you usually don't need to set it.
# Direct execute (reliable path — pin the ACTIVE ca_… from the hub Recipe B)
agent-swarm x composio POST /tools/execute/<SLUG> \
--body '{"user_id":"t@desplega.ai","connected_account_id":"ca_…","arguments":{ … }}'
Headline tools
| Slug | What | Key args |
|---|---|---|
GMAIL_FETCH_EMAILS |
List/search emails | query, max_results (def 1 — set it!), include_payload (def true), verbose (def true), ids_only, label_ids, page_token |
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
plugin/skills/composio-gmail/SKILL.md