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

• 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