composio-connect

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

一款可在1000+款应用中执行操作的通用工具。这是一个备选技能——仅当没有其他技能可覆盖用户请求的服务时才可使用。

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                           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│ 决策：是否应该使用Composio？                                    │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ 1. 是否已有其他技能可处理该服务？                                │
│    ├── Gmail/Drive/日历 → google-workspace（使用该技能）         │
│    ├── Slack → slack-automation（使用该技能）                    │
│    ├── CRM (Attio) → attio-crm（使用该技能）                     │
│    ├── GitHub issues → 通过Bash使用gh CLI（使用该方式）           │
│    └── YouTube下载 → youtube-tools（使用该技能）                 │
│                                                                 │
│ 2. 该服务是否未被其他技能覆盖？                                  │
│    ├── Notion、Asana、Trello、Monday → 使用COMPOSIO              │
│    ├── HubSpot、Salesforce、Pipedrive → 使用COMPOSIO             │
│    ├── Jira、Linear、Confluence → 使用COMPOSIO                   │
│    ├── Airtable、Coda、ClickUp → 使用COMPOSIO                    │
│    ├── Stripe、Shopify、QuickBooks → 使用COMPOSIO                │
│    ├── Zendesk、Intercom、Freshdesk → 使用COMPOSIO               │
│    ├── Microsoft 365、Teams、Outlook → 使用COMPOSIO              │
│    ├── Dropbox、Box、OneDrive → 使用COMPOSIO                     │
│    ├── Figma、Canva、Miro → 使用COMPOSIO                         │
│    ├── Zoom、Webex、Google Meet → 使用COMPOSIO                   │
│    └── 其他900+款应用 → 使用COMPOSIO                            │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Environment Setup

环境设置

bash

undefined

bash

undefined

1. Get free API key from https://platform.composio.dev

1. 从https://platform.composio.dev获取免费API密钥

2. Add to .env file

2. 添加到.env文件中

COMPOSIO_API_KEY=your_api_key_here

3. Install SDK

3. 安装SDK

pip install composio-core

undefined

pip install composio-core

undefined

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

你想要执行什么操作？
│
├── 执行单个操作
│   └── python scripts/execute_action.py "通过Gmail给john@example.com发送邮件"
│
├── 列出可用应用
│   └── python scripts/execute_action.py --list-apps
│
├── 列出某应用的可用操作
│   └── python scripts/execute_action.py --list-actions notion
│
├── 检查连接状态
│   └── python scripts/execute_action.py --check-connection notion
│
└── 连接新应用
    └── python scripts/execute_action.py --connect notion

Common Usage

常见用法

Execute an Action (Natural Language)

执行操作（自然语言）

bash

undefined

bash

undefined

Let Composio figure out the right tool

让Composio自动选择合适的工具

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"

undefined

python scripts/execute_action.py "在我的工作区中创建一个名为'会议记录'的Notion页面" python scripts/execute_action.py "在Asana中添加任务：审核Q4预算" python scripts/execute_action.py "为结账流程中的Bug创建一个Linear工单" python scripts/execute_action.py "给lead@company.com发送HubSpot邮件"

undefined

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

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

undefined

bash

undefined

This will provide an OAuth link to authorize

这会提供一个OAuth授权链接

python scripts/execute_action.py --connect notion python scripts/execute_action.py --connect hubspot python scripts/execute_action.py --connect jira

undefined

python scripts/execute_action.py --connect notion python scripts/execute_action.py --connect hubspot python scripts/execute_action.py --connect jira

undefined

Execute Specific Action

执行特定操作

bash

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

bash

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

应用	常见操作
Notion	创建页面、添加数据库条目、搜索
Asana	创建任务、更新项目、分配任务
Trello	创建卡片、移动卡片、添加评论
Monday	创建项目项、更新列、发送通知
ClickUp	创建任务、更新状态、添加评论
Coda	创建文档、更新表格、运行自动化
Airtable	创建记录、更新字段、查询数据库

CRM & Sales

CRM与销售

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

应用	常见操作
HubSpot	创建联系人、更新交易、发送邮件
Salesforce	创建线索、更新销售机会、记录通话
Pipedrive	创建交易、更新联系人、添加活动
Zoho CRM	创建记录、更新模块、发送邮件
Close	创建线索、记录通话、发送邮件

Development & DevOps

开发与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

应用	常见操作
Jira	创建工单、更新状态、添加评论
Linear	创建工单、分配任务、更新优先级
Confluence	创建页面、更新空间、添加评论
GitLab	创建工单、合并请求、流水线操作
Bitbucket	创建PR、添加评论、更新工单

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

应用	常见操作
Zendesk	创建工单、更新状态、添加备注
Intercom	发送消息、创建对话、标记用户
Freshdesk	创建工单、回复、更新优先级
Help Scout	创建对话、发送回复、标记

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

应用	常见操作
Stripe	创建发票、检查支付状态、退款
Shopify	创建订单、更新产品、检查库存
QuickBooks	创建发票、记录支付、添加费用
Xero	创建发票、对账、添加联系人
Square	创建支付、更新商品目录、发送收据

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

应用	常见操作
Microsoft Teams	发送消息、创建频道、安排会议
Zoom	创建会议、发送邀请、获取录制文件
Discord	发送消息、创建频道、管理角色
Twilio	发送短信、拨打电话、发送WhatsApp消息

Design & Creative

设计与创意

App	Common Actions
Figma	Get file, export assets, add comment
Canva	Create design, export, share
Miro	Create board, add sticky, export

应用	常见操作
Figma	获取文件、导出资源、添加评论
Canva	创建设计、导出、分享
Miro	创建白板、添加便签、导出

Storage & Files

存储与文件

App	Common Actions
Dropbox	Upload file, share link, create folder
Box	Upload, share, manage permissions
OneDrive	Upload, share, sync

应用	常见操作
Dropbox	上传文件、分享链接、创建文件夹
Box	上传、分享、管理权限
OneDrive	上传、分享、同步

First-Time Authentication Flow

首次认证流程

When connecting to a new app for the first time:

Run connect command:

bash

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

首次连接新应用时：

运行连接命令：

bash

python scripts/execute_action.py --connect notion

你将收到一个OAuth链接：

请授权Composio访问Notion：
https://app.composio.dev/authorize/notion?token=xxx

点击链接并在浏览器中完成授权
在终端中确认：
```
授权是否完成？(y/n): y
```
连接已保存 - 后续请求将自动生效

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

Composio API： 提供免费层级（请查看platform.composio.dev了解限制）
大多数操作无单次操作费用
高级应用可能需要付费Composio套餐

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

将
```
COMPOSIO_API_KEY
```
存储在
```
.env
```
文件中（绝对不要提交到代码仓库）
OAuth令牌由Composio安全存储
可随时通过platform.composio.dev撤销访问权限

Permissions

权限

Each app requests only necessary OAuth scopes
Review permissions before authorizing
Connections can be removed individually

每个应用仅请求必要的OAuth权限范围
授权前请查看权限说明
可单独移除应用连接

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

Composio仅处理请求，不存储用户数据
操作直接与连接的服务执行
如需详情请查看Composio的隐私政策

Troubleshooting

故障排除

Issue: "App not connected"

问题：“应用未连接”

Solution: Run

--connect <app>

and complete OAuth flow

解决方案： 运行

--connect <应用名>

并完成OAuth流程

Issue: "Invalid API key"

问题：“无效API密钥”

Solution: Check COMPOSIO_API_KEY in .env, regenerate if needed

解决方案： 检查.env文件中的COMPOSIO_API_KEY，必要时重新生成

Issue: "Action failed"

问题：“操作失败”

Cause: Missing permissions or invalid parameters Solution: Check

--list-actions <app>

for correct action format

原因： 权限不足或参数无效 解决方案： 运行

--list-actions <应用名>

查看正确的操作格式

Issue: "Rate limited"

问题：“请求受限”

Solution: Wait and retry, or upgrade Composio plan

解决方案： 等待后重试，或升级Composio套餐

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

当用户请求的内容不在你的技能范围内时：

检查Composio是否支持该应用
使用Composio执行操作
将结果返回给用户

Chaining Actions

操作链

bash

undefined

bash

undefined

Research → Create Notion summary

调研 → 创建Notion总结

1. Use parallel-research for research

1. 使用parallel-research进行调研

2. Use composio to create Notion page with results

2. 使用composio创建包含结果的Notion页面

Scrape → Update CRM

爬取 → 更新CRM

1. Use apify-scrapers to get company data

1. 使用apify-scrapers获取公司数据

2. Use composio to update HubSpot contact

2. 使用composio更新HubSpot联系人

undefined

undefined

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

Composio平台： https://platform.composio.dev
API文档： https://docs.composio.dev
支持应用列表： https://app.composio.dev/apps
references/apps-catalog.md - 1000+支持应用的完整列表
references/actions-guide.md - 按分类整理的常见操作