connect
💡 Summary
A skill that enables Claude to execute real-world actions across 1000+ applications like Gmail, Slack, and GitHub via API integrations.
🎯 Target Audience
🤖 AI Roast: “It's the ultimate 'I'll do it for you' skill, turning Claude from a thoughtful advisor into an over-eager intern with access to all your accounts.”
The skill delegates execution to a third-party service (Composio) which gains broad OAuth permissions to user accounts (email, databases, social media). This creates a high-risk supply chain and privilege escalation vector. Mitigation: Strictly audit and limit the OAuth scopes granted to the Composio connection, and implement a secondary approval mechanism for sensitive actions.
name: connect description: Connect Claude to any app. Send emails, create issues, post messages, update databases - take real actions across Gmail, Slack, GitHub, Notion, and 1000+ services.
Connect
Connect Claude to any app. Stop generating text about what you could do - actually do it.
When to Use This Skill
Use this skill when you need Claude to:
- Send that email instead of drafting it
- Create that issue instead of describing it
- Post that message instead of suggesting it
- Update that database instead of explaining how
What Changes
| Without Connect | With Connect | |-----------------|--------------| | "Here's a draft email..." | Sends the email | | "You should create an issue..." | Creates the issue | | "Post this to Slack..." | Posts it | | "Add this to Notion..." | Adds it |
Supported Apps
1000+ integrations including:
- Email: Gmail, Outlook, SendGrid
- Chat: Slack, Discord, Teams, Telegram
- Dev: GitHub, GitLab, Jira, Linear
- Docs: Notion, Google Docs, Confluence
- Data: Sheets, Airtable, PostgreSQL
- CRM: HubSpot, Salesforce, Pipedrive
- Storage: Drive, Dropbox, S3
- Social: Twitter, LinkedIn, Reddit
Setup
1. Get API Key
Get your free key at platform.composio.dev
2. Set Environment Variable
export COMPOSIO_API_KEY="your-key"
3. Install
pip install composio # Python npm install @composio/core # TypeScript
Done. Claude can now connect to any app.
Examples
Send Email
Email sarah@acme.com - Subject: "Shipped!" Body: "v2.0 is live, let me know if issues"
Create GitHub Issue
Create issue in my-org/repo: "Mobile timeout bug" with label:bug
Post to Slack
Post to #engineering: "Deploy complete - v2.4.0 live"
Chain Actions
Find GitHub issues labeled "bug" from this week, summarize, post to #bugs on Slack
How It Works
Uses Composio Tool Router:
- You ask Claude to do something
- Tool Router finds the right tool (1000+ options)
- OAuth handled automatically
- Action executes and returns result
Code
from composio import Composio from claude_agent_sdk.client import ClaudeSDKClient from claude_agent_sdk.types import ClaudeAgentOptions import os composio = Composio(api_key=os.environ["COMPOSIO_API_KEY"]) session = composio.create(user_id="user_123") options = ClaudeAgentOptions( system_prompt="You can take actions in external apps.", mcp_servers={ "composio": { "type": "http", "url": session.mcp.url, "headers": {"x-api-key": os.environ["COMPOSIO_API_KEY"]}, } }, ) async with ClaudeSDKClient(options) as client: await client.query("Send Slack message to #general: Hello!")
Auth Flow
First time using an app:
To send emails, I need Gmail access.
Authorize here: https://...
Say "connected" when done.
Connection persists after that.
Framework Support
| Framework | Install |
|-----------|---------|
| Claude Agent SDK | pip install composio claude-agent-sdk |
| OpenAI Agents | pip install composio openai-agents |
| Vercel AI | npm install @composio/core @composio/vercel |
| LangChain | pip install composio-langchain |
| Any MCP Client | Use session.mcp.url |
Troubleshooting
- Auth required → Click link, authorize, say "connected"
- Action failed → Check permissions in target app
- Tool not found → Be specific: "Slack #general" not "send message"
Pros
- Massive integration library (1000+ apps)
- Clear, action-oriented value proposition
- Simplifies complex multi-step workflows
- Supports multiple AI agent frameworks
Cons
- Introduces significant security and compliance surface area
- Dependent on a third-party service (Composio)
- Potential for unintended actions if prompts are misinterpreted
- Requires managing OAuth tokens for many services
Related Skills
mcp-builder
S“This guide is so comprehensive it might just teach the AI to write its own MCP servers and put you out of a job.”
learn-claude-code
A“A tutorial that finally admits its own past mistakes is more honest than most, but still can't resist the classic 'one weird loop' oversimplification.”
langsmith-fetch
A“It's a fantastic debugger for your AI agent, assuming your agent's first mistake wasn't forgetting to enable tracing.”
Disclaimer: This content is sourced from GitHub open source projects for display and rating purposes only.
Copyright belongs to the original author ComposioHQ.
