Composio Integration

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: sonukumar5fr@gmail.com

Status: ACTIVE ✅

Capabilities: Read/send emails, manage labels, drafts, contacts

Google Tasks (ca_kSNnWG4OHngG)

Email: sonukumar5fr@gmail.com

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":"recipient@example.com","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

1. Fetch email 2. Extract key info 3. Create task:

node scripts/execute-tool.mjs GOOGLETASKS_INSERT_TASK ca_kSNnWG4OHngG '{"title":"Follow up: Email subject","notes":"From: sender@example.com"}'

Send Follow-up Email

node scripts/execute-tool.mjs GMAIL_SEND_EMAIL ca_0cxayHx2BME1 '{
  "to":"client@example.com",
  "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