Composio Connect Skill

Description

This skill uses the Composio platform to connect Claude Code with external SaaS applications. Through Composio's unified API, you can read/write data across Gmail, Slack, GitHub, Notion, Jira, Google Sheets, Salesforce, and 500+ other apps.

Instructions

When the user wants to interact with external apps, use Composio:

Setup

Copy
# Install Composio CLI
pip install composio-core

# Authenticate
composio login

# Add an integration (e.g., Gmail)
composio add gmail
# Opens browser for OAuth authentication

# Verify connection
composio whoami
composio connections

Using in Claude Code (via MCP)

Copy
// .claude/settings.json
{
  "mcpServers": {
    "composio": {
      "command": "npx",
      "args": ["-y", "composio-core", "mcp"],
      "env": {
        "COMPOSIO_API_KEY": "your-api-key"
      }
    }
  }
}

Common Integrations

Gmail — Send and read emails:

Action: GMAIL_SEND_EMAIL
Params: { to: "[email protected]", subject: "Deploy Report", body: "..." }

Action: GMAIL_SEARCH
Params: { query: "from:[email protected] after:2025/03/01" }

Slack — Post messages and manage channels:

Action: SLACK_SEND_MESSAGE
Params: { channel: "#deployments", text: "v1.2.0 deployed successfully" }

Action: SLACK_LIST_CHANNELS
Params: { types: "public_channel" }

Notion — Create and update pages:

Action: NOTION_CREATE_PAGE
Params: { parent_id: "...", title: "Sprint Retro", content: "..." }

Action: NOTION_SEARCH
Params: { query: "API documentation" }

Linear — Manage issues:

Action: LINEAR_CREATE_ISSUE
Params: { title: "Fix auth bug", team: "Backend", priority: "high" }

Action: LINEAR_LIST_ISSUES
Params: { filter: { state: "In Progress", assignee: "me" } }

Google Sheets — Read/write spreadsheet data:

Action: GOOGLE_SHEETS_READ
Params: { spreadsheet_id: "...", range: "Sheet1!A1:D100" }

Action: GOOGLE_SHEETS_APPEND
Params: { spreadsheet_id: "...", range: "Sheet1", values: [["data", "row"]] }

Automation Workflows

Combine multiple apps in a workflow:

Copy
## Example: Deploy Notification Workflow
1. GitHub: Check if all checks pass on PR #123
2. Slack: Post "Starting deploy" to #deployments
3. [Deploy happens]
4. Linear: Move related issues to "Done"
5. Gmail: Send release notes to stakeholders
6. Notion: Update changelog page

Rules

• Always authenticate integrations via composio add <app> before using them
• Store the COMPOSIO_API_KEY in environment variables, never in code
• Check available actions for an app with composio actions <app>
• Use the minimum required OAuth scopes for each integration
• Handle rate limits from target apps gracefully (retry with backoff)
• For bulk operations, batch requests when the API supports it
• Test integrations in a sandbox/staging environment first
• Review OAuth permissions before granting access to any app
• Log all cross-app actions for audit trail

Examples

User: Send the deploy report to the team via Slack and email Action: Post formatted message to Slack channel, send email via Gmail to distribution list

User: Create a Linear ticket from this GitHub issue Action: Read GitHub issue details, create Linear issue with matching title, description, and priority

User: Sync our Notion docs with Google Sheets tracking Action: Read Notion database, extract relevant fields, append/update rows in Google Sheets