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

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:

node scripts/execute-tool.mjs GMAIL_FETCH_EMAILS ca_0cxayHx2BME1 '{"maxResults":5}'

Create Google Task:

node scripts/execute-tool.mjs GOOGLETASKS_INSERT_TASK ca_kSNnWG4OHngG '{"title":"My Task","notes":"Task details"}'

Send Email:

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

node scripts/execute-tool.mjs GMAIL_FETCH_EMAILS ca_0cxayHx2BME1 '{"maxResults":10,"labelIds":["INBOX"]}'

Add Task from Email

Fetch email
Extract key info
Create task:

node scripts/execute-tool.mjs GOOGLETASKS_INSERT_TASK ca_kSNnWG4OHngG '{"title":"Follow up: Email subject","notes":"From: [email protected]"}'

Send Follow-up Email

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.):

Visit: https://app.composio.dev/apps
Click "Connect" on desired app
Complete OAuth flow
Note the connected_account_id
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

Composio Integration