Composio Integration

Access and manage Gmail emails and Google Tasks via Composio's unified API with tools for sending, searching, creating tasks, and more.

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: [e-mail]
• Status: ACTIVE ✅
• Capabilities: Read/send emails, manage labels, drafts, contacts

Google Tasks (ca_kSNnWG4OHngG)

• Email: [e-mail]
• 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":"[e-mail]","subject":"Hello","body":"Hi there!"}'

🔧 Implementation Details

Base URL (v3 API)

text

https://backend.composio.dev/api/v3/

Authentication

All requests use header:

text

x-api-key: ak_AXxQjyexBuSiJXTYOTPB

User ID

All tool executions use:

text

user_id: pg-test-228260f1-217f-40f6-a08a-41fdd0b8d8e6

Scripts Location

text

/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: [e-mail]"}'

Send Follow-up Email

bash

node scripts/execute-tool.mjs GMAIL_SEND_EMAIL ca_0cxayHx2BME1 '{
  "to":"[e-mail]",
  "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