What this skill does

# Composio Integration Skill Access 600+ apps and services through Composio's unified API. Currently connected: Gmail and Google Tasks. ## 🔑 API Key Location **Saved securely in:** `/home/sidharth/clawd/memory/composio-credentials.md` **Also in:** `~/.bashrc` (line 135) - auto-loads on terminal start **API Key:** `ak_AXxQjyexBuSiJXTYOTPB` ## 📦 Connected Accounts ### Gmail (ca_0cxayHx2BME1) - **Email:** [email protected] - **Status:** ACTIVE ✅ - **Capabilities:** Read/send emails, manage labels, drafts, contacts ### Google Tasks (ca_kSNnWG4OHngG) - **Email:** [email protected] - **Status:** ACTIVE ✅ - **Capabilities:** Create/update/delete tasks and task lists ## 🛠️ Available Tools ### Gmail Tools (20+) - `GMAIL_FETCH_EMAILS` - Fetch emails - `GMAIL_SEND_EMAIL` - Send emails - `GMAIL_CREATE_EMAIL_DRAFT` - Create draft - `GMAIL_REPLY_TO_THREAD` - Reply to email - `GMAIL_SEARCH_EMAILS` - Search inbox - `GMAIL_ADD_LABEL_TO_EMAIL` - Manage labels - `GMAIL_DELETE_MESSAGE` - Delete emails - And 13+ more... ### Google Tasks Tools (17) - `GOOGLETASKS_INSERT_TASK` - Create task - `GOOGLETASKS_LIST_TASKS` - List tasks - `GOOGLETASKS_LIST_ALL_TASKS` - List all tasks across all lists - `GOOGLETASKS_UPDATE_TASK` - Update task - `GOOGLETASKS_DELETE_TASK` - Delete task - `GOOGLETASKS_CREATE_TASK_LIST` - Create task list - `GOOGLETASKS_BULK_INSERT_TASKS` - Bulk create tasks - And 10+ more... ## 📝 Usage Examples ### List Available Tools ```bash export COMPOSIO_API_KEY="ak_AXxQjyexBuSiJXTYOTPB" node scripts/list-tools.mjs gmail # Gmail tools only node scripts/list-tools.mjs googletasks # Google Tasks tools node scripts/list-tools.mjs # All tools (paginated) ``` ### Execute a Tool **Fetch Gmail Emails:** ```bash node scripts/execute-tool.mjs GMAIL_FETCH_EMAILS ca_0cxayHx2BME1 '{"maxResults":5}' ``` **Create Google Task:** ```bash node scripts/execute-tool.mjs GOOGLETASKS_INSERT_TASK ca_kSNnWG4OHngG '{"title":"My Task","notes":"Task details"}' ``` **Send Email:** ```bash node scripts/execute-tool.mjs GMAIL_SEND_EMAIL ca_0cxayHx2BME1 '{"to":"[email protected]","subject":"Hello","body":"Hi there!"}' ``` ## 🔧 Implementation Details ### Base URL (v3 API) ``` https://backend.composio.dev/api/v3/ ``` ### Authentication All requests use header: ``` x-api-key: ak_AXxQjyexBuSiJXTYOTPB ``` ### User ID All tool executions use: ``` user_id: pg-test-228260f1-217f-40f6-a08a-41fdd0b8d8e6 ``` ### Scripts Location ``` /home/sidharth/clawd/skills/composio-integration/scripts/ ├── list-tools.mjs # List available tools ├── execute-tool.mjs # Execute any tool └── (future scripts) ``` ## 🎯 Common Use Cases ### Morning Email Summary ```bash node scripts/execute-tool.mjs GMAIL_FETCH_EMAILS ca_0cxayHx2BME1 '{"maxResults":10,"labelIds":["INBOX"]}' ``` ### Add Task from Email 1. Fetch email 2. Extract key info 3. Create task: ```bash node scripts/execute-tool.mjs GOOGLETASKS_INSERT_TASK ca_kSNnWG4OHngG '{"title":"Follow up: Email subject","notes":"From: [email protected]"}' ``` ### Send Follow-up Email ```bash node scripts/execute-tool.mjs GMAIL_SEND_EMAIL ca_0cxayHx2BME1 '{ "to":"[email protected]", "subject":"Re: Your inquiry", "body":"Thank you for reaching out..." }' ``` ## 🔄 Adding New Apps To connect more apps (Calendar, Notion, Slack, etc.): 1. Visit: https://app.composio.dev/apps 2. Click "Connect" on desired app 3. Complete OAuth flow 4. Note the `connected_account_id` 5. Use with `execute-tool.mjs` ## 📚 API Reference **Full v3 API Docs:** https://docs.composio.dev/rest-api/ **Key Endpoints Used:** - `GET /api/v3/tools` - List tools - `GET /api/v3/tools/:slug` - Get tool schema - `POST /api/v3/tools/execute/:slug` - Execute tool - `GET /api/v3/connected_accounts` - List connections ## ✅ Tested & Working - ✅ API key authentication - ✅ Gmail email fetching - ✅ Tool discovery (600+ apps) - ✅ Connected account management - ✅ v3 API compliance (no deprecated endpoints) ## 🚀 Next Steps - [ ] Create wrapper functions for common tasks - [ ] Add Google Calendar integration - [ ] Build email-to-task automation - [ ] Create morning digest generator - [ ] Add error handling & retry logic --- **Last Updated:** 2026-01-20 **Status:** ✅ Fully Operational **Integration Time:** ~30 minutes