Composio Connect
Overview
Universal action executor for 1,000+ apps. This is a fallback skill - only use when no other skill covers the requested service.
When to Use This Skill
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β DECISION: Should I use Composio? β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β β
β 1. Does another skill already handle this service? β
β βββ Gmail/Drive/Calendar β google-workspace (USE THAT) β
β βββ Slack β slack-automation (USE THAT) β
β βββ CRM (Attio) β attio-crm (USE THAT) β
β βββ GitHub issues β Use gh CLI via Bash (USE THAT) β
β βββ YouTube downloads β youtube-tools (USE THAT) β
β β
β 2. Is the service NOT covered by other skills? β
β βββ Notion, Asana, Trello, Monday β USE COMPOSIO β
β βββ HubSpot, Salesforce, Pipedrive β USE COMPOSIO β
β βββ Jira, Linear, Confluence β USE COMPOSIO β
β βββ Airtable, Coda, ClickUp β USE COMPOSIO β
β βββ Stripe, Shopify, QuickBooks β USE COMPOSIO β
β βββ Zendesk, Intercom, Freshdesk β USE COMPOSIO β
β βββ Microsoft 365, Teams, Outlook β USE COMPOSIO β
β βββ Dropbox, Box, OneDrive β USE COMPOSIO β
β βββ Figma, Canva, Miro β USE COMPOSIO β
β βββ Zoom, Webex, Google Meet β USE COMPOSIO β
β βββ 900+ other apps β USE COMPOSIO β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Environment Setup
COMPOSIO_API_KEY=your_api_key_here
pip install composio-core
Quick Decision Tree
What do you want to do?
β
βββ Execute a single action
β βββ python scripts/execute_action.py "Send email via Gmail to [email protected]"
β
βββ List available apps
β βββ python scripts/execute_action.py --list-apps
β
βββ List actions for an app
β βββ python scripts/execute_action.py --list-actions notion
β
βββ Check connection status
β βββ python scripts/execute_action.py --check-connection notion
β
βββ Connect to a new app
βββ python scripts/execute_action.py --connect notion
Common Usage
Execute an Action (Natural Language)
python scripts/execute_action.py "Create a Notion page titled 'Meeting Notes' in my workspace"
python scripts/execute_action.py "Add a task to Asana: Review Q4 budget"
python scripts/execute_action.py "Create a Linear issue for bug in checkout flow"
python scripts/execute_action.py "Send a HubSpot email to [email protected]"
List Available Apps
python scripts/execute_action.py --list-apps
python scripts/execute_action.py --list-apps --category crm
python scripts/execute_action.py --list-apps --category productivity
Connect to an App (First Time)
python scripts/execute_action.py --connect notion
python scripts/execute_action.py --connect hubspot
python scripts/execute_action.py --connect jira
Execute Specific Action
python scripts/execute_action.py --app notion --action create_page --params '{"title": "My Page", "content": "Hello world"}'
Supported Apps by Category
Productivity & Docs
| App |
Common Actions |
| Notion |
Create page, add database entry, search |
| Asana |
Create task, update project, assign |
| Trello |
Create card, move card, add comment |
| Monday |
Create item, update column, notify |
| ClickUp |
Create task, update status, add comment |
| Coda |
Create doc, update table, run automation |
| Airtable |
Create record, update field, query base |
CRM & Sales
| App |
Common Actions |
| HubSpot |
Create contact, update deal, send email |
| Salesforce |
Create lead, update opportunity, log call |
| Pipedrive |
Create deal, update person, add activity |
| Zoho CRM |
Create record, update module, send email |
| Close |
Create lead, log call, send email |
Development & DevOps
| App |
Common Actions |
| Jira |
Create issue, update status, add comment |
| Linear |
Create issue, assign, update priority |
| Confluence |
Create page, update space, add comment |
| GitLab |
Create issue, merge request, pipeline |
| Bitbucket |
Create PR, add comment, update issue |
Customer Support
| App |
Common Actions |
| Zendesk |
Create ticket, update status, add note |
| Intercom |
Send message, create conversation, tag user |
| Freshdesk |
Create ticket, reply, update priority |
| Help Scout |
Create conversation, send reply, tag |
Finance & E-commerce
| App |
Common Actions |
| Stripe |
Create invoice, check payment, refund |
| Shopify |
Create order, update product, check inventory |
| QuickBooks |
Create invoice, record payment, add expense |
| Xero |
Create invoice, reconcile, add contact |
| Square |
Create payment, update catalog, send receipt |
Communication
| App |
Common Actions |
| Microsoft Teams |
Send message, create channel, schedule meeting |
| Zoom |
Create meeting, send invite, get recording |
| Discord |
Send message, create channel, manage roles |
| Twilio |
Send SMS, make call, send WhatsApp |
Design & Creative
| App |
Common Actions |
| Figma |
Get file, export assets, add comment |
| Canva |
Create design, export, share |
| Miro |
Create board, add sticky, export |
Storage & Files
| App |
Common Actions |
| Dropbox |
Upload file, share link, create folder |
| Box |
Upload, share, manage permissions |
| OneDrive |
Upload, share, sync |
First-Time Authentication Flow
When connecting to a new app for the first time:
-
Run connect command:
python scripts/execute_action.py --connect notion
-
You'll receive an OAuth URL:
Please authorize Composio to access Notion:
https://app.composio.dev/authorize/notion?token=xxx
-
Click the link and authorize in your browser
-
Confirm back in terminal:
Authorization complete? (y/n): y
-
Connection is now saved - future requests work automatically
Cost
- Composio API: Free tier available (check platform.composio.dev for limits)
- No per-action cost for most operations
- Premium apps may require paid Composio plan
Security Notes
Credential Handling
- Store
COMPOSIO_API_KEY in .env (never commit)
- OAuth tokens are stored securely by Composio
- Revoke access anytime via platform.composio.dev
Permissions
- Each app requests only necessary OAuth scopes
- Review permissions before authorizing
- Connections can be removed individually
Data Privacy
- Composio processes requests but doesn't store your data
- Actions execute directly with the connected service
- Review Composio's privacy policy for details
Troubleshooting
Issue: "App not connected"
Solution: Run --connect <app> and complete OAuth flow
Issue: "Invalid API key"
Solution: Check COMPOSIO_API_KEY in .env, regenerate if needed
Issue: "Action failed"
Cause: Missing permissions or invalid parameters
Solution: Check --list-actions <app> for correct action format
Issue: "Rate limited"
Solution: Wait and retry, or upgrade Composio plan
Integration with Other Skills
Fallback Pattern
When user asks for something not in your skills:
- Check if Composio supports the app
- Use Composio to execute the action
- Return results to user
Chaining Actions
Resources