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
- Fetch email
- Extract key info
- 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.):
- 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
Last Updated: 2026-01-20
Status: β
Fully Operational
Integration Time: ~30 minutes