Composio Connect

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

CRM & Sales

Development & DevOps

Customer Support

Finance & E-commerce

Communication

Design & Creative

Storage & Files

First-Time Authentication Flow

When connecting to a new app for the first time:

1. Run connect command:

   python scripts/execute_action.py --connect notion
   

2. You'll receive an OAuth URL:

   Please authorize Composio to access Notion:
   https://app.composio.dev/authorize/notion?token=xxx
   

3. Click the link and authorize in your browser

4. Confirm back in terminal:

   Authorization complete? (y/n): y
   

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

1. Check if Composio supports the app
2. Use Composio to execute the action
3. 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

• Composio Platform: https://platform.composio.dev
• API Documentation: https://docs.composio.dev
• Supported Apps List: https://app.composio.dev/apps
• references/apps-catalog.md - Full list of 1,000+ supported apps
• references/actions-guide.md - Common actions by category