From 1b3f6521a820a8d5f63117ae5cdf1dc9e14dced2 Mon Sep 17 00:00:00 2001 From: Prathit <67639393+Prat011@users.noreply.github.com> Date: Mon, 12 Jan 2026 13:01:39 +0530 Subject: [PATCH] Add connect skill (#46) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Add Connect skill + improve CTAs - Add new Connect skill for integrating Claude with external apps (Gmail, Slack, GitHub, Notion, and 1000+ services via Composio) - Update README with link to Connect skill - Add visual signup CTA with social proof at bottom - Soften community section CTAs 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 * Add composio-toolrouter plugin + quickstart - Add composio-toolrouter plugin for connecting Claude to 1000+ apps - Rename connect -> connect-apps skill - Add quickstart section to README with 3-step setup - Plugin setup asks for API key and configures ~/.mcp.json Flow: 1. claude --plugin-dir ./composio-toolrouter 2. /composio-toolrouter:setup (enter API key) 3. "Send me a test email" → aha moment 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 * Rename plugin to connect-apps - Rename composio-toolrouter -> connect-apps-plugin - Update README quickstart and plugin references 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --------- Co-authored-by: Sujay Choubey Co-authored-by: Claude Opus 4.5 --- README.md | 31 +++++++ .../.claude-plugin/plugin.json | 8 ++ connect-apps-plugin/README.md | 47 +++++++++++ connect-apps-plugin/commands/setup.md | 67 ++++++++++++++++ connect-apps/SKILL.md | 80 +++++++++++++++++++ 5 files changed, 233 insertions(+) create mode 100644 connect-apps-plugin/.claude-plugin/plugin.json create mode 100644 connect-apps-plugin/README.md create mode 100644 connect-apps-plugin/commands/setup.md create mode 100644 connect-apps/SKILL.md diff --git a/README.md b/README.md index ca79e01..8a14adb 100644 --- a/README.md +++ b/README.md @@ -35,9 +35,40 @@ A curated list of practical Claude Skills for enhancing productivity across Claude.ai, Claude Code, and the Claude API. +--- + +## Quickstart: Connect Claude to 500+ Apps + +The **connect-apps** plugin lets Claude perform real actions - send emails, create issues, post to Slack. It handles auth and connects to 500+ apps using Composio under the hood. + +### 1. Install the Plugin + +```bash +claude --plugin-dir ./connect-apps-plugin +``` + +### 2. Run Setup + +``` +/connect-apps:setup +``` + +Paste your API key when asked. (Get a free key at [platform.composio.dev](https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills)) + +### 3. Restart & Try It + +```bash +exit +claude +``` > **Want skills that do more than generate text?** Claude can send emails, create issues, post to Slack, and take actions across 1000+ apps. [See how →](./connect/) +If you receive the email, Claude is now connected to 500+ apps. + +**[See all supported apps →](./connect-apps/)** + +--- ## Contents diff --git a/connect-apps-plugin/.claude-plugin/plugin.json b/connect-apps-plugin/.claude-plugin/plugin.json new file mode 100644 index 0000000..2055b15 --- /dev/null +++ b/connect-apps-plugin/.claude-plugin/plugin.json @@ -0,0 +1,8 @@ +{ + "name": "connect-apps", + "description": "Manage auth and connect to 500+ apps using Composio. Perform real actions from Claude Code - send emails, create issues, post messages, and more.", + "author": { + "name": "Composio", + "email": "support@composio.dev" + } +} diff --git a/connect-apps-plugin/README.md b/connect-apps-plugin/README.md new file mode 100644 index 0000000..d4977c9 --- /dev/null +++ b/connect-apps-plugin/README.md @@ -0,0 +1,47 @@ +# Connect Apps Plugin + +Let Claude perform real actions in 500+ apps. Handles auth and connections using Composio under the hood. + +## Install + +```bash +claude --plugin-dir ./connect-apps-plugin +``` + +Then run the setup: +``` +/connect-apps:setup +``` + +## What You Get + +Once installed, Claude can: +- **Send emails** via Gmail, Outlook +- **Create issues** on GitHub, GitLab, Jira, Linear +- **Post messages** to Slack, Discord, Teams +- **Update docs** in Notion, Google Docs +- **Manage data** in Sheets, Airtable, databases +- **And 500+ more actions** + +## How It Works + +1. Get a free API key from [platform.composio.dev](https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills) +2. Run `/connect-apps:setup` and paste your key +3. Restart Claude Code +4. First time using an app, you'll authorize via OAuth +5. That's it - Claude can now take real actions + +## Try It + +After setup, ask Claude: +``` +Send me a test email at myemail@example.com +``` + +--- + +

+ + Get API Key + +

diff --git a/connect-apps-plugin/commands/setup.md b/connect-apps-plugin/commands/setup.md new file mode 100644 index 0000000..f9b33cc --- /dev/null +++ b/connect-apps-plugin/commands/setup.md @@ -0,0 +1,67 @@ +--- +description: Set up connect-apps - let Claude perform real actions in 500+ apps +allowed-tools: [Bash, Write, AskUserQuestion] +--- + +# Connect Apps Setup + +Set up the connect-apps plugin so Claude can take real actions in external apps (Gmail, Slack, GitHub, etc). Uses Composio for auth and app connections. + +## Instructions + +### Step 1: Ask for API Key + +Ask the user for their Composio API key. If they don't have one, tell them to get a free key at: https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills + +Just ask for the key directly. Don't ask if they have one first. + +### Step 2: Validate & Get MCP URL + +Run this command (replace API_KEY_HERE with the actual key): + +```bash +/opt/homebrew/bin/python3.11 -c " +from composio import Composio +composio = Composio(api_key='API_KEY_HERE') +session = composio.create(user_id='claude_user') +print(session.mcp.url) +" +``` + +If it fails with import error, first run: `pip3 install composio` + +### Step 3: Write Config + +Write directly to `~/.mcp.json` with this exact format: + +```json +{ + "connect-apps": { + "type": "http", + "url": "THE_MCP_URL_FROM_STEP_2", + "headers": { + "x-api-key": "THE_API_KEY" + } + } +} +``` + +If ~/.mcp.json already exists with other servers, merge the "connect-apps" key into the existing JSON. + +### Step 4: Confirm + +Tell the user: +``` +Setup complete! + +To activate: exit and run `claude` again + +Then try: "Send me a test email at your@email.com" +``` + +## Important + +- Do NOT try to edit settings.local.json - MCP servers go in ~/.mcp.json +- Do NOT search for config locations - just write to ~/.mcp.json +- Do NOT ask multiple questions - just ask for the API key once +- Be fast - this should take under 30 seconds diff --git a/connect-apps/SKILL.md b/connect-apps/SKILL.md new file mode 100644 index 0000000..094c77d --- /dev/null +++ b/connect-apps/SKILL.md @@ -0,0 +1,80 @@ +--- +name: connect-apps +description: Connect Claude to external apps like Gmail, Slack, GitHub. Use this skill when the user wants to send emails, create issues, post messages, or take actions in external services. +--- + +# Connect Apps + +Connect Claude to 1000+ apps. Actually send emails, create issues, post messages - not just generate text about it. + +## Quick Start + +### Step 1: Install the Plugin + +``` +/plugin install composio-toolrouter +``` + +### Step 2: Run Setup + +``` +/composio-toolrouter:setup +``` + +This will: +- Ask for your free API key (get one at [platform.composio.dev](https://platform.composio.dev/?utm_source=Github&utm_content=AwesomeSkills)) +- Configure Claude's connection to 1000+ apps +- Take about 60 seconds + +### Step 3: Try It! + +After setup, restart Claude Code and try: + +``` +Send me a test email at YOUR_EMAIL@example.com +``` + +If it works, you're connected! + +## What You Can Do + +| Ask Claude to... | What happens | +|------------------|--------------| +| "Send email to sarah@acme.com about the launch" | Actually sends the email | +| "Create GitHub issue: fix login bug" | Creates the issue | +| "Post to Slack #general: deploy complete" | Posts the message | +| "Add meeting notes to Notion" | Adds to Notion | + +## 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...** + +## How It Works + +1. You ask Claude to do something +2. Composio Tool Router finds the right tool +3. First time? You'll authorize via OAuth (one-time) +4. Action executes and returns result + +## Troubleshooting + +- **"Plugin not found"** → Make sure you ran `/plugin install composio-toolrouter` +- **"Need to authorize"** → Click the OAuth link Claude provides, then say "done" +- **Action failed** → Check you have permissions in the target app + +--- + +

+ Join 20,000+ developers building agents that ship +

+ +

+ + Get Started + +