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
# 1. Get free API key from https://platform.composio.dev
# 2. Add to .env file
COMPOSIO_API_KEY=your_api_key_here
# 3. Install SDK
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 john@example.com"
│
├── 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)
# Let Composio figure out the right tool
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 lead@company.com"
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)
# This will provide an OAuth link to authorize
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
# Research → Create Notion summary
# 1. Use parallel-research for research
# 2. Use composio to create Notion page with results
# Scrape → Update CRM
# 1. Use apify-scrapers to get company data
# 2. Use composio to update HubSpot contact
Resources
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: composio-connect3description: Universal fallback for executing actions across 1,000+ apps when no other skill is available. Use this skill ONLY when user requests an action on an app/service not covered by other skills (e.g., Notion, Asana, Trello, HubSpot, Airtable, Linear, Monday, Zendesk, Intercom, Stripe, Shopify, QuickBooks, Zoom, Microsoft 365, Dropbox, Box, Figma, Jira, Confluence, etc.). Do NOT use if another skill already handles the service. Triggers on requests to connect to external apps, execute actions on third-party services, or when user asks "can you actually do X" for an unsupported service. Use when this capability is needed.4---56# Composio Connect78## Overview910Universal action executor for 1,000+ apps. This is a **fallback skill** - only use when no other skill covers the requested service.1112## When to Use This Skill1314```15┌─────────────────────────────────────────────────────────────────┐16│ DECISION: Should I use Composio? │17├─────────────────────────────────────────────────────────────────┤18│ │19│ 1. Does another skill already handle this service? │20│ ├── Gmail/Drive/Calendar → google-workspace (USE THAT) │21│ ├── Slack → slack-automation (USE THAT) │22│ ├── CRM (Attio) → attio-crm (USE THAT) │23│ ├── GitHub issues → Use gh CLI via Bash (USE THAT) │24│ └── YouTube downloads → youtube-tools (USE THAT) │25│ │26│ 2. Is the service NOT covered by other skills? │27│ ├── Notion, Asana, Trello, Monday → USE COMPOSIO │28│ ├── HubSpot, Salesforce, Pipedrive → USE COMPOSIO │29│ ├── Jira, Linear, Confluence → USE COMPOSIO │30│ ├── Airtable, Coda, ClickUp → USE COMPOSIO │31│ ├── Stripe, Shopify, QuickBooks → USE COMPOSIO │32│ ├── Zendesk, Intercom, Freshdesk → USE COMPOSIO │33│ ├── Microsoft 365, Teams, Outlook → USE COMPOSIO │34│ ├── Dropbox, Box, OneDrive → USE COMPOSIO │35│ ├── Figma, Canva, Miro → USE COMPOSIO │36│ ├── Zoom, Webex, Google Meet → USE COMPOSIO │37│ └── 900+ other apps → USE COMPOSIO │38│ │39└─────────────────────────────────────────────────────────────────┘40```4142## Environment Setup4344```bash45# 1. Get free API key from https://platform.composio.dev46# 2. Add to .env file47COMPOSIO_API_KEY=your_api_key_here4849# 3. Install SDK50pip install composio-core51```5253## Quick Decision Tree5455```56What do you want to do?57│58├── Execute a single action59│ └── python scripts/execute_action.py "Send email via Gmail to john@example.com"60│61├── List available apps62│ └── python scripts/execute_action.py --list-apps63│64├── List actions for an app65│ └── python scripts/execute_action.py --list-actions notion66│67├── Check connection status68│ └── python scripts/execute_action.py --check-connection notion69│70└── Connect to a new app71 └── python scripts/execute_action.py --connect notion72```7374## Common Usage7576### Execute an Action (Natural Language)77```bash78# Let Composio figure out the right tool79python scripts/execute_action.py "Create a Notion page titled 'Meeting Notes' in my workspace"80python scripts/execute_action.py "Add a task to Asana: Review Q4 budget"81python scripts/execute_action.py "Create a Linear issue for bug in checkout flow"82python scripts/execute_action.py "Send a HubSpot email to lead@company.com"83```8485### List Available Apps86```bash87python scripts/execute_action.py --list-apps88python scripts/execute_action.py --list-apps --category crm89python scripts/execute_action.py --list-apps --category productivity90```9192### Connect to an App (First Time)93```bash94# This will provide an OAuth link to authorize95python scripts/execute_action.py --connect notion96python scripts/execute_action.py --connect hubspot97python scripts/execute_action.py --connect jira98```99100### Execute Specific Action101```bash102python scripts/execute_action.py --app notion --action create_page --params '{"title": "My Page", "content": "Hello world"}'103```104105## Supported Apps by Category106107### Productivity & Docs108| App | Common Actions |109|-----|----------------|110| Notion | Create page, add database entry, search |111| Asana | Create task, update project, assign |112| Trello | Create card, move card, add comment |113| Monday | Create item, update column, notify |114| ClickUp | Create task, update status, add comment |115| Coda | Create doc, update table, run automation |116| Airtable | Create record, update field, query base |117118### CRM & Sales119| App | Common Actions |120|-----|----------------|121| HubSpot | Create contact, update deal, send email |122| Salesforce | Create lead, update opportunity, log call |123| Pipedrive | Create deal, update person, add activity |124| Zoho CRM | Create record, update module, send email |125| Close | Create lead, log call, send email |126127### Development & DevOps128| App | Common Actions |129|-----|----------------|130| Jira | Create issue, update status, add comment |131| Linear | Create issue, assign, update priority |132| Confluence | Create page, update space, add comment |133| GitLab | Create issue, merge request, pipeline |134| Bitbucket | Create PR, add comment, update issue |135136### Customer Support137| App | Common Actions |138|-----|----------------|139| Zendesk | Create ticket, update status, add note |140| Intercom | Send message, create conversation, tag user |141| Freshdesk | Create ticket, reply, update priority |142| Help Scout | Create conversation, send reply, tag |143144### Finance & E-commerce145| App | Common Actions |146|-----|----------------|147| Stripe | Create invoice, check payment, refund |148| Shopify | Create order, update product, check inventory |149| QuickBooks | Create invoice, record payment, add expense |150| Xero | Create invoice, reconcile, add contact |151| Square | Create payment, update catalog, send receipt |152153### Communication154| App | Common Actions |155|-----|----------------|156| Microsoft Teams | Send message, create channel, schedule meeting |157| Zoom | Create meeting, send invite, get recording |158| Discord | Send message, create channel, manage roles |159| Twilio | Send SMS, make call, send WhatsApp |160161### Design & Creative162| App | Common Actions |163|-----|----------------|164| Figma | Get file, export assets, add comment |165| Canva | Create design, export, share |166| Miro | Create board, add sticky, export |167168### Storage & Files169| App | Common Actions |170|-----|----------------|171| Dropbox | Upload file, share link, create folder |172| Box | Upload, share, manage permissions |173| OneDrive | Upload, share, sync |174175## First-Time Authentication Flow176177When connecting to a new app for the first time:1781791. **Run connect command:**180 ```bash181 python scripts/execute_action.py --connect notion182 ```1831842. **You'll receive an OAuth URL:**185 ```186 Please authorize Composio to access Notion:187 https://app.composio.dev/authorize/notion?token=xxx188 ```1891903. **Click the link and authorize in your browser**1911924. **Confirm back in terminal:**193 ```194 Authorization complete? (y/n): y195 ```1961975. **Connection is now saved** - future requests work automatically198199## Cost200201- **Composio API:** Free tier available (check platform.composio.dev for limits)202- **No per-action cost** for most operations203- **Premium apps** may require paid Composio plan204205## Security Notes206207### Credential Handling208- Store `COMPOSIO_API_KEY` in `.env` (never commit)209- OAuth tokens are stored securely by Composio210- Revoke access anytime via platform.composio.dev211212### Permissions213- Each app requests only necessary OAuth scopes214- Review permissions before authorizing215- Connections can be removed individually216217### Data Privacy218- Composio processes requests but doesn't store your data219- Actions execute directly with the connected service220- Review Composio's privacy policy for details221222## Troubleshooting223224### Issue: "App not connected"225**Solution:** Run `--connect <app>` and complete OAuth flow226227### Issue: "Invalid API key"228**Solution:** Check COMPOSIO_API_KEY in .env, regenerate if needed229230### Issue: "Action failed"231**Cause:** Missing permissions or invalid parameters232**Solution:** Check `--list-actions <app>` for correct action format233234### Issue: "Rate limited"235**Solution:** Wait and retry, or upgrade Composio plan236237## Integration with Other Skills238239### Fallback Pattern240When user asks for something not in your skills:2411. Check if Composio supports the app2422. Use Composio to execute the action2433. Return results to user244245### Chaining Actions246```bash247# Research → Create Notion summary248# 1. Use parallel-research for research249# 2. Use composio to create Notion page with results250251# Scrape → Update CRM252# 1. Use apify-scrapers to get company data253# 2. Use composio to update HubSpot contact254```255256## Resources257258- **Composio Platform:** https://platform.composio.dev259- **API Documentation:** https://docs.composio.dev260- **Supported Apps List:** https://app.composio.dev/apps261- **references/apps-catalog.md** - Full list of 1,000+ supported apps262- **references/actions-guide.md** - Common actions by category263264---265> Converted and distributed by [TomeVault](https://tomevault.io/claim/casper-studios) — claim your Tome and manage your conversions.266<!-- tomevault:4.0:skill_md:2026-04-12 -->
tomevault-io