connect-apps

Connect Apps

Connect Claude to 1000+ apps using the Composio CLI. Actually send emails, create issues, post messages - not just generate text about it.

Quick Start

Step 1: Install the Composio CLI

curl -fsSL https://composio.dev/install | bash

Step 2: Log In

composio login
composio whoami

Opens a browser for auth, then prompts you to pick a default org and project. Use -y to skip prompts in scripts.

Step 3: Link the Apps You Need

composio link gmail
composio link slack
composio link github

Each command walks OAuth once; the connection then persists.

Step 4: Try It

composio execute GMAIL_SEND_EMAIL -d '{
  "recipient_email": "YOUR_EMAIL@example.com",
  "subject": "Composio test",
  "body": "Hello from the CLI"
}'

If the email arrives, you're connected.

What You Can Do

Ask Claude to...	Claude runs
"Send email to sarah@acme.com about the launch"	composio execute GMAIL_SEND_EMAIL -d '{...}'
"Create GitHub issue: fix login bug"	composio execute GITHUB_CREATE_ISSUE -d '{...}'
"Post to Slack #general: deploy complete"	composio execute SLACK_SEND_MESSAGE -d '{...}'
"Add meeting notes to Notion"	composio execute NOTION_CREATE_PAGE -d '{...}'

Core Workflow

1. Know the tool slug? → composio execute <SLUG> -d '{...}'
2. Don't know it? → composio search "what you want"
3. Need inputs? → composio execute <SLUG> --get-schema or --dry-run
4. Not connected? → composio link <toolkit> and retry
5. Multi-step? → composio run for JS/TS workflows, composio proxy for raw API

Supported Apps

Email: Gmail, Outlook, SendGrid Chat: Slack, Discord, Teams, Telegram Dev: GitHub, GitLab, Jira, Linear Docs: Notion, Google Docs, Confluence Data: Sheets, Airtable, PostgreSQL And 1000+ more...

Handy Commands

# Discover tools
composio search "create a github issue"
composio tools list gmail
composio tools info GITHUB_CREATE_ISSUE

# Inspect / dry-run before executing
composio execute GITHUB_CREATE_ISSUE --get-schema
composio execute GITHUB_CREATE_ISSUE --dry-run -d '{"owner":"acme","repo":"app","title":"Bug"}'

# Execute in parallel
composio execute --parallel \
  GMAIL_FETCH_EMAILS -d '{"max_results": 2}' \
  GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'

# Multi-step workflow
composio run '
  const issue = await execute("GITHUB_CREATE_ISSUE", {
    owner: "acme", repo: "app", title: "Bug", body: "..."
  });
  console.log(issue);
'

# Raw API call when no dedicated tool exists
composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile --toolkit gmail

Configuration

Environment variables:

• COMPOSIO_API_KEY - auth credential for non-interactive use
• COMPOSIO_BASE_URL - custom API endpoint
• COMPOSIO_SESSION_DIR - override artifact storage
• COMPOSIO_DISABLE_TELEMETRY=true - opt out

Global flags: --log-level <all|trace|debug|info|warning|error|fatal|none>, --help.

Troubleshooting

• Not logged in → run composio login
• Connection required for <toolkit> → run composio link <toolkit>
• Unknown slug → composio search "<goal>" or composio tools list <toolkit>
• Bad inputs → composio execute <SLUG> --get-schema then --dry-run
• Action failed → check permissions in the target app

Full reference: docs.composio.dev/docs/cli

---