@devries-cameron20 / composio Mirror · read-only / commits / 4fbd95270
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 22, 18:15 UTC

navigation high level changes

Sushmithamallesh committed Nov 25, 2025 at 09:58 UTC 4fbd95270cbe540690ca4cfdda952c8b095bca5c
5 files changed +917 -8
fern/docs.yml
+83 -8
@@ -90,10 +90,16 @@ redirects:
90 destination: /type-script
91 - source: /sdk-reference/type-script/:path
92 destination: /type-script/:path
93 +- source: /docs/tool-router/quick-start
94 + destination: /tool-router/overview
95 tabs:
96 docs:
97 display-name: Docs
98 slug: docs
99 + tool-router:
100 + display-name: Tool Router
101 + icon: fa-sparkles
102 + slug: tool-router
103 providers:
104 display-name: Providers
105 skip-slug: true
@@ -128,6 +134,24 @@ navigation:
134 - changelog: ./pages/src/changelog
135 title: Changelog
136 slug: changelog
137 + - section: Capabilities
138 + icon: fa-layer-group
139 + skip-slug: true
140 + contents:
141 + - link: Tool Router
142 + href: /tool-router/overview
143 + - page: Managed Authentication
144 + path: pages/dist/capabilities/managed-authentication.mdx
145 + slug: managed-authentication
146 + - page: Tools
147 + path: pages/dist/capabilities/tools.mdx
148 + slug: tools
149 + - page: MCP
150 + path: pages/dist/capabilities/mcp.mdx
151 + slug: mcp
152 + - page: Triggers
153 + path: pages/dist/capabilities/triggers.mdx
154 + slug: triggers
155 - section: Tools and Triggers
156 icon: fa-light fa-wrench
157 skip-slug: true
@@ -194,13 +218,6 @@ navigation:
218 - page: Providers
219 path: pages/dist/mcp/providers.mdx
220 slug: mcp-providers
197 - - section: Tool Router (Beta)
198 - icon: fa-light fa-flask
199 - skip-slug: true
200 - contents:
201 - - page: Quick Start
202 - path: pages/dist/tool-router/quick-start.mdx
203 - slug: tool-router/quick-start
221 - section: Resources
222 icon: fa-light fa-book
223 skip-slug: true
@@ -253,6 +270,64 @@ navigation:
270 - page: Triggers
271 path: pages/dist/resources/troubleshooting/triggers.mdx
272 slug: triggers
273 +- tab: tool-router
274 + layout:
275 + - section: Get Started
276 + icon: fa-light fa-rocket
277 + skip-slug: true
278 + contents:
279 + - page: Overview
280 + path: pages/dist/tool-router/overview.mdx
281 + slug: overview
282 + - page: Quickstart
283 + path: pages/dist/tool-router/quickstart.mdx
284 + slug: quickstart
285 + - section: Core Concepts
286 + icon: fa-light fa-brain
287 + skip-slug: true
288 + contents:
289 + - page: Understanding Tool Router
290 + path: pages/dist/tool-router/understanding-tool-router.mdx
291 + slug: understanding-tool-router
292 + - page: Sessions
293 + path: pages/dist/tool-router/sessions.mdx
294 + slug: sessions
295 + - page: Meta-Tools
296 + path: pages/dist/tool-router/meta-tools.mdx
297 + slug: meta-tools
298 + - section: Configuration
299 + icon: fa-light fa-cog
300 + skip-slug: true
301 + contents:
302 + - page: Toolkit Management
303 + path: pages/dist/tool-router/toolkit-management.mdx
304 + slug: toolkit-management
305 + - page: Permissions
306 + path: pages/dist/tool-router/permissions.mdx
307 + slug: permissions
308 + - section: Authentication
309 + icon: fa-light fa-key
310 + skip-slug: true
311 + contents:
312 + - page: Authentication Flows
313 + path: pages/dist/tool-router/authentication-flows.mdx
314 + slug: authentication-flows
315 + - page: White-Labeling
316 + path: pages/dist/tool-router/white-labeling.mdx
317 + slug: white-labeling
318 + - section: Integration
319 + icon: fa-light fa-plug
320 + skip-slug: true
321 + contents:
322 + - page: MCP Integration
323 + path: pages/dist/tool-router/mcp-integration.mdx
324 + slug: mcp-integration
325 + - page: Native SDK
326 + path: pages/dist/tool-router/native-sdk.mdx
327 + slug: native-sdk
328 + - page: Framework Examples
329 + path: pages/dist/tool-router/framework-examples.mdx
330 + slug: framework-examples
331 - tab: providers
332 layout:
333 - section: Supported Providers
@@ -417,4 +492,4 @@ navigation:
492 contents:
493 - page: Tool Generator
494 path: pages/dist/examples/tool-generator/tool-generator.mdx
420 - slug: examples/tool-generator
495 + slug: examples/tool-generator
\ No newline at end of file
fern/pages/src/capabilities/managed-authentication.mdx new
+164
@@ -0,0 +1,164 @@
1 +---
2 +title: Managed Authentication
3 +image: "https://og.composio.dev/api/og?title=Managed%20Authentication&description=Enterprise-grade%20authentication%20for%20AI%20agents"
4 +subtitle: "Enterprise-grade authentication for AI agents"
5 +description: "Let your AI agents authenticate with 800+ apps on behalf of users. OAuth, API keys, user isolation, and white-labeling built in."
6 +keywords: "managed authentication, ai agent auth, oauth, api keys, user isolation, white-labeling, connected accounts"
7 +hide-nav-links: false
8 +---
9 +
10 +~~**Let your AI agents authenticate with 800+ apps on behalf of users**
11 +Zero-config OAuth flows, automatic token refresh, and complete user isolation—all managed for you.~~
12 +
13 +## ~~Key capabilities~~
14 +
15 +<CardGroup cols={2}>
16 + <Card title="800+ pre-configured apps" icon="fa-solid fa-plug">
17 + ~~OAuth flows, API keys, and credentials for every major platform—no setup required.~~
18 + </Card>
19 +
20 + <Card title="Automatic token management" icon="fa-solid fa-arrows-rotate">
21 + ~~Never worry about expired tokens. Composio handles refresh, rotation, and secure storage.~~
22 + </Card>
23 +
24 + <Card title="Complete user isolation" icon="fa-solid fa-lock">
25 + ~~Each user's credentials are encrypted and isolated. Perfect for multi-tenant applications.~~
26 + </Card>
27 +
28 + <Card title="White-label authentication" icon="fa-solid fa-palette">
29 + ~~Use your own OAuth apps and branded auth screens for a seamless user experience.~~
30 + </Card>
31 +</CardGroup>
32 +
33 +## ~~How it works~~
34 +
35 +<CodeGroup>
36 +```python Python
37 +from composio import Composio
38 +
39 +composio = Composio(api_key="YOUR_API_KEY")
40 +
41 +# Create an authentication link for your user
42 +auth_link = composio.connected_accounts.link(
43 + user_id="user-123",
44 + toolkit="github"
45 +)
46 +
47 +# User authenticates via the link
48 +print(f"Send this link to user: {auth_link.url}")
49 +
50 +# Execute authenticated actions
51 +result = composio.tools.execute(
52 + "GITHUB_CREATE_REPO",
53 + user_id="user-123",
54 + arguments={"name": "my-new-repo"}
55 +)
56 +```
57 +
58 +```typescript TypeScript
59 +import { Composio } from '@composio/core';
60 +
61 +const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
62 +
63 +// Create an authentication link for your user
64 +const authLink = await composio.connectedAccounts.link({
65 + userId: 'user-123',
66 + toolkit: 'github'
67 +});
68 +
69 +// User authenticates via the link
70 +console.log(`Send this link to user: ${authLink.url}`);
71 +
72 +// Execute authenticated actions
73 +const result = await composio.tools.execute('GITHUB_CREATE_REPO', {
74 + userId: 'user-123',
75 + arguments: { name: 'my-new-repo' }
76 +});
77 +```
78 +</CodeGroup>
79 +
80 +## ~~Use cases~~
81 +
82 +### ~~Customer support automation~~
83 +~~Enable support agents to access customer accounts across Zendesk, Intercom, and internal tools—with proper audit trails and permissions.~~
84 +
85 +### ~~Sales automation~~
86 +~~Connect CRM, email, and calendar accounts to automate outreach, follow-ups, and meeting scheduling while maintaining personalization.~~
87 +
88 +### ~~DevOps workflows~~
89 +~~Authenticate with GitHub, GitLab, AWS, and monitoring tools to automate deployments, incident response, and infrastructure management.~~
90 +
91 +### ~~Content management~~
92 +~~Connect social media, CMS, and analytics platforms to schedule posts, manage content, and track performance across channels.~~
93 +
94 +## ~~Authentication methods~~
95 +
96 +<AccordionGroup>
97 + <Accordion title="OAuth 2.0">
98 + ~~Full OAuth flow with automatic token refresh. Supports Google, Microsoft, GitHub, and 500+ other providers.~~
99 + </Accordion>
100 +
101 + <Accordion title="API Keys">
102 + ~~Simple key-based authentication for services like OpenAI, Stripe, and SendGrid. Keys are encrypted at rest.~~
103 + </Accordion>
104 +
105 + <Accordion title="Basic Auth">
106 + ~~Username/password authentication for legacy systems and internal tools. Credentials are securely stored.~~
107 + </Accordion>
108 +
109 + <Accordion title="Custom Credentials">
110 + ~~Support for any authentication method including JWT, session tokens, and proprietary schemes.~~
111 + </Accordion>
112 +</AccordionGroup>
113 +
114 +## ~~Enterprise features~~
115 +
116 +<CardGroup cols={3}>
117 + <Card title="GDPR compliant" icon="fa-solid fa-shield-check">
118 + ~~Data residency options and right-to-be-forgotten support~~
119 + </Card>
120 +
121 + <Card title="SOC 2 Type II" icon="fa-solid fa-certificate">
122 + ~~Annual audits and continuous compliance monitoring~~
123 + </Card>
124 +
125 + <Card title="HIPAA ready" icon="fa-solid fa-hospital">
126 + ~~Healthcare-grade security for sensitive data~~
127 + </Card>
128 +</CardGroup>
129 +
130 +## ~~Get started~~
131 +
132 +<CardGroup cols={2}>
133 + <Card
134 + title="Authentication guide"
135 + icon="fa-solid fa-book"
136 + href="/docs/authenticating-tools"
137 + >
138 + ~~Learn how to authenticate tools and manage connections~~
139 + </Card>
140 +
141 + <Card
142 + title="Custom auth configs"
143 + icon="fa-solid fa-cog"
144 + href="/docs/custom-auth-configs"
145 + >
146 + ~~Use your own OAuth apps and credentials~~
147 + </Card>
148 +
149 + <Card
150 + title="Connected accounts"
151 + icon="fa-solid fa-users"
152 + href="/docs/connected-accounts"
153 + >
154 + ~~Manage user connections throughout their lifecycle~~
155 + </Card>
156 +
157 + <Card
158 + title="White-labeling"
159 + icon="fa-solid fa-palette"
160 + href="/tool-router/white-labeling"
161 + >
162 + ~~Create branded authentication experiences~~
163 + </Card>
164 +</CardGroup>
\ No newline at end of file
fern/pages/src/capabilities/mcp.mdx new
+210
@@ -0,0 +1,210 @@
1 +---
2 +title: MCP (Model Context Protocol)
3 +image: "https://og.composio.dev/api/og?title=MCP&description=Universal%20tool%20protocol%20for%20any%20AI%20client"
4 +subtitle: "Universal tool protocol for any AI client"
5 +description: "Connect 800+ tools to Claude Desktop, Continue.dev, and any MCP-compatible client. Framework-agnostic integration with zero code changes."
6 +keywords: "mcp, model context protocol, claude desktop, continue dev, ai tools, framework agnostic, tool server"
7 +hide-nav-links: false
8 +---
9 +
10 +~~**Connect 800+ tools to any MCP-compatible AI client**
11 +Works with Claude Desktop, Continue.dev, and custom clients—no code changes needed. Just configure and connect.~~
12 +
13 +## ~~Key capabilities~~
14 +
15 +<CardGroup cols={2}>
16 + <Card title="Universal compatibility" icon="fa-solid fa-infinity">
17 + ~~Works with any MCP client—Claude Desktop, Continue.dev, or your custom implementation.~~
18 + </Card>
19 +
20 + <Card title="800+ tools instantly" icon="fa-solid fa-rocket">
21 + ~~All Composio tools available through a single MCP server configuration.~~
22 + </Card>
23 +
24 + <Card title="Zero code required" icon="fa-solid fa-code-branch">
25 + ~~Configure once in JSON, use everywhere. No SDK integration needed.~~
26 + </Card>
27 +
28 + <Card title="Automatic updates" icon="fa-solid fa-arrows-rotate">
29 + ~~New tools and capabilities added automatically without client updates.~~
30 + </Card>
31 +</CardGroup>
32 +
33 +## ~~How it works~~
34 +
35 +<CodeGroup>
36 +```json claude_desktop_config.json
37 +{
38 + "mcpServers": {
39 + "composio": {
40 + "command": "npx",
41 + "args": [
42 + "-y",
43 + "@composio/mcp-server",
44 + "{YOUR_COMPOSIO_API_KEY}"
45 + ]
46 + }
47 + }
48 +}
49 +```
50 +
51 +```python Python SDK Alternative
52 +# Or use the Python MCP server
53 +from composio import Composio
54 +
55 +composio = Composio(api_key="YOUR_API_KEY")
56 +
57 +# Start MCP server
58 +composio.mcp.start_server(
59 + port=3000,
60 + allowed_toolkits=["github", "slack", "gmail"]
61 +)
62 +
63 +# Server now available for any MCP client to connect
64 +print("MCP server running at localhost:3000")
65 +```
66 +
67 +```typescript TypeScript SDK Alternative
68 +// Or use the TypeScript MCP server
69 +import { Composio } from '@composio/core';
70 +
71 +const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
72 +
73 +// Start MCP server
74 +await composio.mcp.startServer({
75 + port: 3000,
76 + allowedToolkits: ['github', 'slack', 'gmail']
77 +});
78 +
79 +// Server now available for any MCP client to connect
80 +console.log('MCP server running at localhost:3000');
81 +```
82 +</CodeGroup>
83 +
84 +## ~~Compatible clients~~
85 +
86 +<CardGroup cols={3}>
87 + <Card title="Claude Desktop" icon="fa-solid fa-desktop">
88 + ~~Native support in Anthropic's desktop application~~
89 + </Card>
90 +
91 + <Card title="Continue.dev" icon="fa-solid fa-code">
92 + ~~AI-powered IDE extension for VS Code and JetBrains~~
93 + </Card>
94 +
95 + <Card title="Custom Clients" icon="fa-solid fa-wrench">
96 + ~~Build your own MCP client with any language or framework~~
97 + </Card>
98 +</CardGroup>
99 +
100 +## ~~Use cases~~
101 +
102 +### ~~IDE-powered development~~
103 +~~Give your IDE assistant the ability to create GitHub issues, search documentation, deploy code, and manage infrastructure—all from natural language.~~
104 +
105 +### ~~Desktop AI assistants~~
106 +~~Transform Claude Desktop into a powerful automation tool that can send emails, manage calendars, update CRMs, and interact with any business tool.~~
107 +
108 +### ~~Custom AI applications~~
109 +~~Build your own MCP client to create specialized AI assistants with access to your entire tool ecosystem without writing integrations.~~
110 +
111 +### ~~Research and analysis~~
112 +~~Enable AI to gather data from multiple sources, compile reports, and take action based on findings—all through a standardized protocol.~~
113 +
114 +## ~~MCP vs Native SDK~~
115 +
116 +<AccordionGroup>
117 + <Accordion title="When to use MCP">
118 + ~~- Working with MCP-compatible clients (Claude Desktop, Continue.dev)~~
119 + ~~- Want framework-agnostic integration~~
120 + ~~- Need quick setup without code changes~~
121 + ~~- Building polyglot applications~~
122 + </Accordion>
123 +
124 + <Accordion title="When to use Native SDK">
125 + ~~- Need programmatic control over tool execution~~
126 + ~~- Want to implement custom authentication flows~~
127 + ~~- Require response transformations or middleware~~
128 + ~~- Building production applications with specific requirements~~
129 + </Accordion>
130 +
131 + <Accordion title="Can I use both?">
132 + ~~Yes! MCP and Native SDK can work together. Use MCP for desktop tools and Native SDK for your application backend.~~
133 + </Accordion>
134 +</AccordionGroup>
135 +
136 +## ~~Server management~~
137 +
138 +<CardGroup cols={2}>
139 + <Card title="Configuration options" icon="fa-solid fa-cog">
140 + ~~Control which tools are exposed, set rate limits, and manage permissions~~
141 + </Card>
142 +
143 + <Card title="Multiple servers" icon="fa-solid fa-server">
144 + ~~Run different MCP servers for different environments or user groups~~
145 + </Card>
146 +
147 + <Card title="Authentication" icon="fa-solid fa-key">
148 + ~~Secure your MCP server with API keys and user-specific access~~
149 + </Card>
150 +
151 + <Card title="Monitoring" icon="fa-solid fa-chart-line">
152 + ~~Track usage, debug issues, and monitor performance~~
153 + </Card>
154 +</CardGroup>
155 +
156 +## ~~Setup guides~~
157 +
158 +<Steps>
159 + <Step title="Get your API key">
160 + ~~Sign up at [app.composio.dev](https://app.composio.dev) and grab your API key~~
161 + </Step>
162 +
163 + <Step title="Configure your client">
164 + ~~Add the Composio MCP server to your client's configuration file~~
165 + </Step>
166 +
167 + <Step title="Authenticate tools">
168 + ~~Connect your accounts (GitHub, Gmail, etc.) through the Composio dashboard~~
169 + </Step>
170 +
171 + <Step title="Start using tools">
172 + ~~Your AI can now access all connected tools through natural language~~
173 + </Step>
174 +</Steps>
175 +
176 +## ~~Get started~~
177 +
178 +<CardGroup cols={2}>
179 + <Card
180 + title="MCP quickstart"
181 + icon="fa-solid fa-rocket"
182 + href="/docs/mcp-quickstart"
183 + >
184 + ~~Set up MCP with Claude Desktop in 5 minutes~~
185 + </Card>
186 +
187 + <Card
188 + title="Server management"
189 + icon="fa-solid fa-server"
190 + href="/docs/mcp-server-management"
191 + >
192 + ~~Configure and manage your MCP servers~~
193 + </Card>
194 +
195 + <Card
196 + title="MCP providers"
197 + icon="fa-solid fa-plug"
198 + href="/docs/mcp-providers"
199 + >
200 + ~~Integration guides for different MCP clients~~
201 + </Card>
202 +
203 + <Card
204 + title="Troubleshooting"
205 + icon="fa-solid fa-wrench"
206 + href="/docs/troubleshooting/mcp"
207 + >
208 + ~~Common MCP issues and solutions~~
209 + </Card>
210 +</CardGroup>
\ No newline at end of file
fern/pages/src/capabilities/tools.mdx new
+214
@@ -0,0 +1,214 @@
1 +---
2 +title: Tools
3 +image: "https://og.composio.dev/api/og?title=Tools&description=800%2B%20authenticated%20actions%20for%20AI%20agents"
4 +subtitle: "800+ authenticated actions for AI agents"
5 +description: "Give your AI agents the ability to execute real-world actions across 800+ integrations. From GitHub commits to Slack messages—all with user authentication built in."
6 +keywords: "ai tools, agent tools, authenticated actions, tool calling, github actions, slack integration, gmail api"
7 +hide-nav-links: false
8 +---
9 +
10 +~~**Give your AI agents the ability to take real-world actions**
11 +800+ pre-built integrations with authentication, error handling, and response formatting—ready to use in one line of code.~~
12 +
13 +## ~~Key capabilities~~
14 +
15 +<CardGroup cols={2}>
16 + <Card title="800+ integrations" icon="fa-solid fa-plug">
17 + ~~GitHub, Slack, Gmail, Jira, Notion, and hundreds more—all pre-configured and ready.~~
18 + </Card>
19 +
20 + <Card title="User authentication built-in" icon="fa-solid fa-user-lock">
21 + ~~Every tool execution is scoped to the authenticated user. No credential mixing.~~
22 + </Card>
23 +
24 + <Card title="Automatic error handling" icon="fa-solid fa-shield">
25 + ~~Rate limiting, retries, and graceful degradation handled automatically.~~
26 + </Card>
27 +
28 + <Card title="Structured outputs" icon="fa-solid fa-code">
29 + ~~Consistent JSON responses optimized for LLM consumption and parsing.~~
30 + </Card>
31 +</CardGroup>
32 +
33 +## ~~How it works~~
34 +
35 +<CodeGroup>
36 +```python Python
37 +from composio import Composio
38 +
39 +composio = Composio(api_key="YOUR_API_KEY")
40 +
41 +# Get tools for a user
42 +tools = composio.tools.get(
43 + user_id="user-123",
44 + toolkits=["github", "slack"]
45 +)
46 +
47 +# Execute any tool with natural language arguments
48 +result = composio.tools.execute(
49 + "GITHUB_CREATE_ISSUE",
50 + user_id="user-123",
51 + arguments={
52 + "repo": "my-repo",
53 + "title": "Bug: Login not working",
54 + "body": "Users report login failures after update"
55 + }
56 +)
57 +
58 +print(f"Issue created: {result.data['html_url']}")
59 +```
60 +
61 +```typescript TypeScript
62 +import { Composio } from '@composio/core';
63 +
64 +const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
65 +
66 +// Get tools for a user
67 +const tools = await composio.tools.get({
68 + userId: 'user-123',
69 + toolkits: ['github', 'slack']
70 +});
71 +
72 +// Execute any tool with natural language arguments
73 +const result = await composio.tools.execute('GITHUB_CREATE_ISSUE', {
74 + userId: 'user-123',
75 + arguments: {
76 + repo: 'my-repo',
77 + title: 'Bug: Login not working',
78 + body: 'Users report login failures after update'
79 + }
80 +});
81 +
82 +console.log(`Issue created: ${result.data.html_url}`);
83 +```
84 +</CodeGroup>
85 +
86 +## ~~Popular integrations~~
87 +
88 +<CardGroup cols={4}>
89 + <Card title="GitHub" icon="fa-brands fa-github">
90 + ~~Create issues, manage PRs, deploy code~~
91 + </Card>
92 +
93 + <Card title="Slack" icon="fa-brands fa-slack">
94 + ~~Send messages, create channels, manage users~~
95 + </Card>
96 +
97 + <Card title="Gmail" icon="fa-solid fa-envelope">
98 + ~~Send emails, manage drafts, organize inbox~~
99 + </Card>
100 +
101 + <Card title="Notion" icon="fa-solid fa-n">
102 + ~~Create pages, update databases, manage workspace~~
103 + </Card>
104 +
105 + <Card title="Jira" icon="fa-brands fa-jira">
106 + ~~Create tickets, update status, manage sprints~~
107 + </Card>
108 +
109 + <Card title="Linear" icon="fa-solid fa-lines-leaning">
110 + ~~Track issues, update projects, manage cycles~~
111 + </Card>
112 +
113 + <Card title="Discord" icon="fa-brands fa-discord">
114 + ~~Send messages, manage servers, create webhooks~~
115 + </Card>
116 +
117 + <Card title="HubSpot" icon="fa-solid fa-h">
118 + ~~Manage contacts, deals, and marketing campaigns~~
119 + </Card>
120 +</CardGroup>
121 +
122 +## ~~Use cases~~
123 +
124 +### ~~Customer support automation~~
125 +~~Automatically create support tickets, update CRM records, and send follow-up emails based on customer interactions.~~
126 +
127 +### ~~DevOps workflows~~
128 +~~Trigger deployments, create GitHub issues from error logs, and send Slack notifications—all from natural language commands.~~
129 +
130 +### ~~Sales automation~~
131 +~~Update CRM records, schedule follow-ups, send personalized emails, and track deal progress across multiple platforms.~~
132 +
133 +### ~~Content publishing~~
134 +~~Cross-post to social media, update CMS, schedule publications, and track analytics across all your content channels.~~
135 +
136 +## ~~Tool categories~~
137 +
138 +<AccordionGroup>
139 + <Accordion title="Developer tools">
140 + ~~GitHub, GitLab, Bitbucket, Linear, Jira, PagerDuty, Datadog, Sentry~~
141 + </Accordion>
142 +
143 + <Accordion title="Communication">
144 + ~~Slack, Discord, Microsoft Teams, Gmail, Outlook, Twilio, SendGrid~~
145 + </Accordion>
146 +
147 + <Accordion title="Productivity">
148 + ~~Notion, Asana, Trello, Monday.com, Airtable, Google Workspace~~
149 + </Accordion>
150 +
151 + <Accordion title="Sales & Marketing">
152 + ~~HubSpot, Salesforce, Pipedrive, Mailchimp, ActiveCampaign, Intercom~~
153 + </Accordion>
154 +
155 + <Accordion title="Social Media">
156 + ~~Twitter/X, LinkedIn, Facebook, Instagram, YouTube, TikTok~~
157 + </Accordion>
158 +
159 + <Accordion title="Storage & Files">
160 + ~~Google Drive, Dropbox, Box, OneDrive, AWS S3, SharePoint~~
161 + </Accordion>
162 +</AccordionGroup>
163 +
164 +## ~~Advanced features~~
165 +
166 +<CardGroup cols={3}>
167 + <Card title="Custom tools" icon="fa-solid fa-wrench">
168 + ~~Create your own tools with custom logic and integrate any API~~
169 + </Card>
170 +
171 + <Card title="Tool versioning" icon="fa-solid fa-code-branch">
172 + ~~Pin specific versions for stability or use latest for new features~~
173 + </Card>
174 +
175 + <Card title="Response modifiers" icon="fa-solid fa-filter">
176 + ~~Transform outputs to match your application's needs~~
177 + </Card>
178 +</CardGroup>
179 +
180 +## ~~Get started~~
181 +
182 +<CardGroup cols={2}>
183 + <Card
184 + title="Browse all toolkits"
185 + icon="fa-solid fa-grid"
186 + href="/toolkits/introduction"
187 + >
188 + ~~Explore the full catalog of available integrations~~
189 + </Card>
190 +
191 + <Card
192 + title="Fetching tools"
193 + icon="fa-solid fa-download"
194 + href="/docs/fetching-tools"
195 + >
196 + ~~Learn how to retrieve and filter tools for your agents~~
197 + </Card>
198 +
199 + <Card
200 + title="Executing tools"
201 + icon="fa-solid fa-play"
202 + href="/docs/executing-tools"
203 + >
204 + ~~Execute tools and handle responses in your application~~
205 + </Card>
206 +
207 + <Card
208 + title="Custom tools"
209 + icon="fa-solid fa-hammer"
210 + href="/docs/custom-tools"
211 + >
212 + ~~Build your own tools for proprietary systems~~
213 + </Card>
214 +</CardGroup>
\ No newline at end of file
fern/pages/src/capabilities/triggers.mdx new
+246
@@ -0,0 +1,246 @@
1 +---
2 +title: Triggers
3 +image: "https://og.composio.dev/api/og?title=Triggers&description=Real-time%20events%20from%20800%2B%20integrations"
4 +subtitle: "Real-time events from 800+ integrations"
5 +description: "React to events as they happen across your connected services. From GitHub commits to Slack messages—build event-driven AI workflows with zero webhook infrastructure."
6 +keywords: "webhooks, triggers, real-time events, event-driven, github webhooks, slack events, automation"
7 +hide-nav-links: false
8 +---
9 +
10 +~~**Build event-driven AI workflows without managing webhooks**
11 +Automatically react to events from GitHub, Slack, Gmail, and 800+ other services—all webhooks and polling handled for you.~~
12 +
13 +## ~~Key capabilities~~
14 +
15 +<CardGroup cols={2}>
16 + <Card title="Real-time event streams" icon="fa-solid fa-bolt">
17 + ~~Instant notifications when events occur across any connected service.~~
18 + </Card>
19 +
20 + <Card title="Zero webhook setup" icon="fa-solid fa-plug-circle-xmark">
21 + ~~No need to configure endpoints, manage SSL, or handle retries—we do it all.~~
22 + </Card>
23 +
24 + <Card title="Unified event format" icon="fa-solid fa-layer-group">
25 + ~~Consistent event structure across all services for easier processing.~~
26 + </Card>
27 +
28 + <Card title="Built-in filtering" icon="fa-solid fa-filter">
29 + ~~Filter events by type, user, or custom criteria before they reach your app.~~
30 + </Card>
31 +</CardGroup>
32 +
33 +## ~~How it works~~
34 +
35 +<CodeGroup>
36 +```python Python
37 +from composio import Composio
38 +
39 +composio = Composio(api_key="YOUR_API_KEY")
40 +
41 +# Set up a trigger for GitHub push events
42 +trigger = composio.triggers.subscribe(
43 + user_id="user-123",
44 + trigger_name="GITHUB_PUSH_EVENT",
45 + config={
46 + "repository": "my-repo",
47 + "branch": "main"
48 + }
49 +)
50 +
51 +# Handle incoming events
52 +@trigger.on_event
53 +def handle_push(event):
54 + print(f"New commit: {event['commit_message']}")
55 +
56 + # Automatically create a deployment
57 + composio.tools.execute(
58 + "VERCEL_CREATE_DEPLOYMENT",
59 + user_id="user-123",
60 + arguments={
61 + "repo": event["repository"],
62 + "branch": event["branch"]
63 + }
64 + )
65 +```
66 +
67 +```typescript TypeScript
68 +import { Composio } from '@composio/core';
69 +
70 +const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
71 +
72 +// Set up a trigger for GitHub push events
73 +const trigger = await composio.triggers.subscribe({
74 + userId: 'user-123',
75 + triggerName: 'GITHUB_PUSH_EVENT',
76 + config: {
77 + repository: 'my-repo',
78 + branch: 'main'
79 + }
80 +});
81 +
82 +// Handle incoming events
83 +trigger.onEvent((event) => {
84 + console.log(`New commit: ${event.commit_message}`);
85 +
86 + // Automatically create a deployment
87 + composio.tools.execute('VERCEL_CREATE_DEPLOYMENT', {
88 + userId: 'user-123',
89 + arguments: {
90 + repo: event.repository,
91 + branch: event.branch
92 + }
93 + });
94 +});
95 +```
96 +</CodeGroup>
97 +
98 +## ~~Popular triggers~~
99 +
100 +<CardGroup cols={4}>
101 + <Card title="GitHub" icon="fa-brands fa-github">
102 + ~~Push, PR, issue, release, star events~~
103 + </Card>
104 +
105 + <Card title="Slack" icon="fa-brands fa-slack">
106 + ~~Message, reaction, channel, member events~~
107 + </Card>
108 +
109 + <Card title="Gmail" icon="fa-solid fa-envelope">
110 + ~~New email, label change, attachment events~~
111 + </Card>
112 +
113 + <Card title="Calendar" icon="fa-solid fa-calendar">
114 + ~~Event created, updated, reminder events~~
115 + </Card>
116 +
117 + <Card title="Stripe" icon="fa-brands fa-stripe">
118 + ~~Payment, subscription, invoice events~~
119 + </Card>
120 +
121 + <Card title="Jira" icon="fa-brands fa-jira">
122 + ~~Issue created, status change, sprint events~~
123 + </Card>
124 +
125 + <Card title="HubSpot" icon="fa-solid fa-h">
126 + ~~Contact, deal, ticket activity events~~
127 + </Card>
128 +
129 + <Card title="Discord" icon="fa-brands fa-discord">
130 + ~~Message, reaction, member join events~~
131 + </Card>
132 +</CardGroup>
133 +
134 +## ~~Use cases~~
135 +
136 +### ~~Automated DevOps~~
137 +~~Trigger deployments on GitHub pushes, create Jira tickets from Sentry errors, and send Slack notifications for critical alerts—all automatically.~~
138 +
139 +### ~~Customer success automation~~
140 +~~React to support tickets, customer emails, and chat messages to automatically update CRM records and trigger follow-up actions.~~
141 +
142 +### ~~Content workflow automation~~
143 +~~Publish blog posts when documents are approved, cross-post to social media on content updates, and trigger translations for new content.~~
144 +
145 +### ~~Sales pipeline automation~~
146 +~~Update deal stages based on email interactions, schedule follow-ups from calendar events, and sync activity across all sales tools.~~
147 +
148 +## ~~Event types~~
149 +
150 +<AccordionGroup>
151 + <Accordion title="Repository events">
152 + ~~Push, pull request, issue, release, star, fork, branch creation/deletion~~
153 + </Accordion>
154 +
155 + <Accordion title="Communication events">
156 + ~~Message sent/received, channel created, member joined, reaction added~~
157 + </Accordion>
158 +
159 + <Accordion title="Document events">
160 + ~~File created/updated, page edited, comment added, permission changed~~
161 + </Accordion>
162 +
163 + <Accordion title="Calendar events">
164 + ~~Event created/updated/deleted, attendee response, reminder triggered~~
165 + </Accordion>
166 +
167 + <Accordion title="Payment events">
168 + ~~Payment succeeded/failed, subscription created/cancelled, invoice paid~~
169 + </Accordion>
170 +
171 + <Accordion title="Workflow events">
172 + ~~Task created/completed, status changed, assignee updated, due date changed~~
173 + </Accordion>
174 +</AccordionGroup>
175 +
176 +## ~~Advanced features~~
177 +
178 +<CardGroup cols={3}>
179 + <Card title="Event filtering" icon="fa-solid fa-filter">
180 + ~~Filter events before they reach your app to reduce noise~~
181 + </Card>
182 +
183 + <Card title="Batch processing" icon="fa-solid fa-layer-group">
184 + ~~Group related events for efficient bulk processing~~
185 + </Card>
186 +
187 + <Card title="Replay events" icon="fa-solid fa-clock-rotate-left">
188 + ~~Replay historical events for testing or recovery~~
189 + </Card>
190 +</CardGroup>
191 +
192 +## ~~Reliability guarantees~~
193 +
194 +<CardGroup cols={2}>
195 + <Card title="At-least-once delivery" icon="fa-solid fa-check-double">
196 + ~~Every event is guaranteed to be delivered at least once~~
197 + </Card>
198 +
199 + <Card title="Automatic retries" icon="fa-solid fa-rotate">
200 + ~~Failed deliveries are automatically retried with exponential backoff~~
201 + </Card>
202 +
203 + <Card title="Event ordering" icon="fa-solid fa-arrow-down-1-9">
204 + ~~Events from the same source maintain their chronological order~~
205 + </Card>
206 +
207 + <Card title="Idempotency" icon="fa-solid fa-fingerprint">
208 + ~~Each event has a unique ID to prevent duplicate processing~~
209 + </Card>
210 +</CardGroup>
211 +
212 +## ~~Get started~~
213 +
214 +<CardGroup cols={2}>
215 + <Card
216 + title="Using triggers"
217 + icon="fa-solid fa-bolt"
218 + href="/docs/using-triggers"
219 + >
220 + ~~Learn how to subscribe to and handle trigger events~~
221 + </Card>
222 +
223 + <Card
224 + title="Available triggers"
225 + icon="fa-solid fa-list"
226 + href="/toolkits/introduction"
227 + >
228 + ~~Browse all available triggers by toolkit~~
229 + </Card>
230 +
231 + <Card
232 + title="Event-driven workflows"
233 + icon="fa-solid fa-diagram-project"
234 + href="/examples/slack-summariser"
235 + >
236 + ~~See real examples of trigger-based automations~~
237 + </Card>
238 +
239 + <Card
240 + title="Troubleshooting"
241 + icon="fa-solid fa-wrench"
242 + href="/docs/troubleshooting/triggers"
243 + >
244 + ~~Debug common trigger issues and solutions~~
245 + </Card>
246 +</CardGroup>
\ No newline at end of file