@devries-cameron20 / composio Mirror · read-only / commits / d2a1b5fbe
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 23:30 UTC

docs(composio-connect): add overview, available MCP tools, and troubleshooting

Expands the composio-connect page so readers understand what the MCP server actually does before jumping into client-specific setup, and know where to go when things break. - Add "How Composio Connect works" section at the top describing the 7 meta-tool architecture and on-demand OAuth model. - Add "Available MCP tools" section listing each meta-tool and its role. - Add "Troubleshooting" section covering the most common reviewer/user issues: missing tools, expired OAuth links, auth failures, removing / reconnecting apps, and where to get support. - Bump "Connect your apps" from h3 to h2 so the trailing sections form a coherent TOC. Motivation: Anthropic MCP Directory submission requires the public docs page to include an overview of what the server does, a tool inventory, and basic troubleshooting guidance. Made-with: Cursor

Shawn Esquivel committed Apr 24, 2026 at 12:14 UTC d2a1b5fbe05129bcf9cc3f91a01db423fc73503b
1 file changed +49 -1
docs/content/docs/composio-connect.mdx
+49 -1
@@ -6,6 +6,14 @@ keywords: [composio connect, mcp, claude code, cursor, vscode, windsurf, cline,
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">
@@ -467,6 +475,46 @@ Use this config with any MCP-compatible client:
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).