Composio lets you connect and act on 1000+ apps like Google Workspace, Slack, GitHub, Notion, Linear, Jira, HubSpot, and more directly from your agent, through the Composio MCP server.
Composio handles OAuth, permissions, and intelligent tool routing, and provides a remote sandbox for bulk data processing.
Composio is compatible with any agent harness, such as Claude Code, Codex, OpenClaw, and Hermes.
Beyond single-app actions, the agent can:
- Run cross-app workflows — e.g. turn the latest GitHub PR into a Linear issue and announce it in Slack; draft a doc from a calendar event.
- Compute in a remote sandbox — aggregate, parse, and transform large tool responses (e.g. sender-domain distributions across hundreds of emails, weekday breakdowns, dedupe/joins) without pulling everything into context.
- Connect apps on demand — fully managed OAuth; the agent hands you an auth link and waits for it to complete.
| Component | Purpose |
|---|---|
mcp.json |
Registers the Composio MCP server (connect.composio.dev/mcp), exposing 7 meta-tools. |
skills/composio-mcp |
Teaches the agent the search → connect → execute workflow and best practices. |
skills/composio-activity-summary |
Generates a cross-app company activity summary (Slack, GitHub, Notion, Linear, Gmail, and more) for a given time period. |
Or add it manually in Cursor → Settings → MCP:
{
"mcpServers": {
"composio": {
"url": "https://connect.composio.dev/mcp"
}
}
}From the Cursor plugin marketplace:
/add-plugin composio
On first use the agent walks you through connecting an app: it returns an OAuth link, you authorize, and the connection becomes available to every future request.
Symlink the repo into Cursor's local plugins, then reload the window
(Developer: Reload Window):
ln -sfn "$PWD" ~/.cursor/plugins/local/composio # remove with: rm ~/.cursor/plugins/local/composioThe plugin exposes 7 COMPOSIO_* meta-tools instead of thousands of individual app
tools. The agent:
- Searches for the right tool with
COMPOSIO_SEARCH_TOOLS. - Connects the app via managed OAuth if needed (
COMPOSIO_MANAGE_CONNECTIONS→COMPOSIO_WAIT_FOR_CONNECTIONS). - Executes one or many tools with
COMPOSIO_MULTI_EXECUTE_TOOL. - Processes large/bulk results in a remote sandbox (
COMPOSIO_REMOTE_WORKBENCH/COMPOSIO_REMOTE_BASH_TOOL).
See skills/composio-mcp/SKILL.md for the full meta-tool reference.
Each query names the apps explicitly, which is what the skill expects — it keeps tool search scoped and the run reliable.
Single app:
What's on my Google Calendar for tomorrow? Add an event for lunch at 12PM.
Cross-app workflow (triage — reads feed the write):
Do the following:
1. Fetch today's unread Gmail emails and unread Slack mentions/DMs
2. Triage them into action items vs. FYI
3. Post a concise summary to a new Notion page amed "Daily Triage"
Parallel workflow (independent reads, fanned out in one batch):
In parallel, search and execute:
- fetch my last 10 Gmail emails
- open Linear issues
- today's Google Calendar events
Redact personal info then give me a concise summary.
Sandbox compute (bulk data, kept out of the chat):
Fetch my last 20 most recent Gmail emails,
- find the promotional/newsletter senders
- rank them by how many emails each sent so I can unsubscribe manually
Use the COMPOSIO_REMOTE_WORKBENCH.
MIT