composio-connect

Original🇺🇸 English
Translated
1 scriptsChecked / no sensitive code detected

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.

3installs
Added on

NPX Install

npx skill4agent add casper-studios/casper-marketplace 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

bash
# 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)

bash
# 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

bash
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)

bash
# 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

bash
python scripts/execute_action.py --app notion --action create_page --params '{"title": "My Page", "content": "Hello world"}'

Supported Apps by Category

Productivity & Docs

AppCommon Actions
NotionCreate page, add database entry, search
AsanaCreate task, update project, assign
TrelloCreate card, move card, add comment
MondayCreate item, update column, notify
ClickUpCreate task, update status, add comment
CodaCreate doc, update table, run automation
AirtableCreate record, update field, query base

CRM & Sales

AppCommon Actions
HubSpotCreate contact, update deal, send email
SalesforceCreate lead, update opportunity, log call
PipedriveCreate deal, update person, add activity
Zoho CRMCreate record, update module, send email
CloseCreate lead, log call, send email

Development & DevOps

AppCommon Actions
JiraCreate issue, update status, add comment
LinearCreate issue, assign, update priority
ConfluenceCreate page, update space, add comment
GitLabCreate issue, merge request, pipeline
BitbucketCreate PR, add comment, update issue

Customer Support

AppCommon Actions
ZendeskCreate ticket, update status, add note
IntercomSend message, create conversation, tag user
FreshdeskCreate ticket, reply, update priority
Help ScoutCreate conversation, send reply, tag

Finance & E-commerce

AppCommon Actions
StripeCreate invoice, check payment, refund
ShopifyCreate order, update product, check inventory
QuickBooksCreate invoice, record payment, add expense
XeroCreate invoice, reconcile, add contact
SquareCreate payment, update catalog, send receipt

Communication

AppCommon Actions
Microsoft TeamsSend message, create channel, schedule meeting
ZoomCreate meeting, send invite, get recording
DiscordSend message, create channel, manage roles
TwilioSend SMS, make call, send WhatsApp

Design & Creative

AppCommon Actions
FigmaGet file, export assets, add comment
CanvaCreate design, export, share
MiroCreate board, add sticky, export

Storage & Files

AppCommon Actions
DropboxUpload file, share link, create folder
BoxUpload, share, manage permissions
OneDriveUpload, share, sync

First-Time Authentication Flow

When connecting to a new app for the first time:
  1. Run connect command:
    bash
    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

bash
# 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