6
7
Give any AI agent the ability to act across 1000+ apps. Bring your agent to where you work.
8
9
+## How Composio Connect works
10
+
11
+Composio Connect is an MCP server at `https://connect.composio.dev/mcp` that gives your AI agent access to 1000+ apps — Gmail, Notion, Slack, GitHub, Linear, HubSpot, Strava, and more — through a single connection.
12
+
13
+Rather than exposing every app tool directly, Composio exposes **7 meta-tools** that let the agent discover what's available, authorize apps on demand, and execute tools across apps in parallel. The first time your agent needs an app, Composio generates an OAuth link you approve in your browser; after that the connection persists across sessions. See [Available MCP tools](#available-mcp-tools) for the full list.
14
+
15
+To get started, pick your client below.
16
+
17
<ConnectFlow>
18
19
<ConnectClientOption id="claude-code" name="Claude Code" description="Terminal-based AI with MCP tools" icon="/images/clients/claude.svg" category="popular">
475
476
</ConnectFlow>
477
470
-### Connect your apps
478
+## Connect your apps
479
480
Your agent will prompt you to connect apps when needed. If you want to connect apps ahead of time, open the [Composio dashboard](https://dashboard.composio.dev) and click **Connect Apps** in the sidebar.
481
+
482
+## Available MCP tools
483
+
484
+Composio Connect exposes 7 meta-tools that orchestrate access to all supported apps. Your agent uses these to discover, connect, and execute upstream tools — you don't need to call them directly.
485
+
486
+- **`COMPOSIO_SEARCH_TOOLS`** — Search the Composio catalog and return relevant tools for a user request, along with a suggested execution plan.
487
+- **`COMPOSIO_GET_TOOL_SCHEMAS`** — Fetch full input schemas for tool slugs returned by search.
488
+- **`COMPOSIO_MULTI_EXECUTE_TOOL`** — Execute one or more discovered tools in parallel across connected apps (up to 50 per call).
489
+- **`COMPOSIO_MANAGE_CONNECTIONS`** — Create, list, rename, or remove OAuth connections to upstream apps.
490
+- **`COMPOSIO_WAIT_FOR_CONNECTIONS`** — Wait for a user to complete an OAuth flow before the agent continues.
491
+- **`COMPOSIO_REMOTE_WORKBENCH`** — Run Python in a remote sandbox for bulk operations or processing large tool responses.
492
+- **`COMPOSIO_REMOTE_BASH_TOOL`** — Run bash in a remote sandbox for file processing and large data handling.
493
+
494
+## Troubleshooting
495
+
496
+### Tools aren't appearing in my agent
497
+
498
+1. Confirm the MCP server is connected. In Claude Desktop, go to **Settings > Connectors** and check that Composio shows a `CUSTOM` badge. In Claude Code, run `/mcp` and confirm Composio is enabled.
499
+2. Clear the connector cache. In Claude Desktop: click the **⋮** next to Composio and select **Clear cache**.
500
+3. If the issue persists, disconnect and re-add the connector:
501
+ - **Claude Desktop** — click **⋮ > Disconnect**, then **Remove**. Re-add via **Add custom connector**.
502
+ - **Claude Code** — re-run the setup command from the Claude Code section above.
503
+
504
+### The OAuth link expired or didn't open
505
+
506
+OAuth links are short-lived. If the browser window doesn't open or the link has expired, ask your agent to retry the action — Composio will generate a fresh link. You can also open the [Composio dashboard](https://dashboard.composio.dev), click **Connect Apps**, and start the flow manually.
507
+
508
+### An app action is failing with an auth error
509
+
510
+1. Open the [Composio dashboard](https://dashboard.composio.dev) and click **Connect Apps**.
511
+2. Find the app in question. If the connection is unhealthy, click **Disconnect** and reconnect.
512
+3. Retry the action in your agent.
513
+
514
+### I want to remove or reconnect an app
515
+
516
+Open [dashboard.composio.dev](https://dashboard.composio.dev) and click **Connect Apps**. From there you can disconnect, delete, or re-authorize any app.
517
+
518
+### I still need help
519
+
520
+Reach out at [tech@composio.dev](mailto:tech@composio.dev) or join the [Composio Discord](https://discord.com/invite/cNruWaAhQk).