1
+---
2
+title: Composio Connect
3
+description: Add Composio tools to your AI agent via MCP
4
+keywords: [composio connect, mcp, claude code, cursor, vscode, windsurf, cline, chatgpt, notion, n8n, codex]
5
+---
6
+
7
+Give any AI agent the ability to act across 1000+ apps. Bring your agent to where you work.
8
+
9
+<ConnectFlow>
10
+
11
+<ConnectClientOption id="claude-code" name="Claude Code" description="Terminal-based AI with MCP tools" icon="/images/clients/claude.svg" category="popular">
12
+
13
+## Claude Code
14
+
15
+<Steps>
16
+<Step>
17
+<StepTitle>Get your API key</StepTitle>
18
+
19
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
20
+
21
+</Step>
22
+<Step>
23
+<StepTitle>Run the setup command</StepTitle>
24
+
25
+Run this in your terminal to add the Composio MCP server to Claude Code.
26
+
27
+```bash
28
+claude mcp add --scope user --transport http composio https://connect.composio.dev/mcp --header "x-consumer-api-key: YOUR_API_KEY"
29
+```
30
+
31
+</Step>
32
+<Step>
33
+<StepTitle>Verify the connection</StepTitle>
34
+
35
+Type `/mcp` in Claude Code to open the MCP server manager and confirm Composio appears and is enabled.
36
+
37
+</Step>
38
+</Steps>
39
+
40
+</ConnectClientOption>
41
+
42
+<ConnectClientOption id="codex" name="Codex" description="OpenAI's coding agent" icon="/images/clients/codex.png" category="popular">
43
+
44
+## Codex
45
+
46
+<Steps>
47
+<Step>
48
+<StepTitle>Get your API key</StepTitle>
49
+
50
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
51
+
52
+</Step>
53
+<Step>
54
+<StepTitle>Open your Codex config</StepTitle>
55
+
56
+Open `~/.codex/config.toml` in your editor. Create the file if it doesn't exist.
57
+
58
+</Step>
59
+<Step>
60
+<StepTitle>Add the Composio server</StepTitle>
61
+
62
+```toml title="~/.codex/config.toml"
63
+[mcp_servers.composio]
64
+url = "https://connect.composio.dev/mcp"
65
+http_headers = { "x-consumer-api-key" = "YOUR_API_KEY" }
66
+```
67
+
68
+</Step>
69
+<Step>
70
+<StepTitle>Verify the connection</StepTitle>
71
+
72
+Run `codex mcp list` to confirm Composio appears as a registered MCP server.
73
+
74
+</Step>
75
+</Steps>
76
+
77
+</ConnectClientOption>
78
+
79
+<ConnectClientOption id="openclaw" name="OpenClaw" description="Open-source personal AI assistant" icon="/images/clients/openclaw.svg" category="popular">
80
+
81
+## OpenClaw
82
+
83
+<Steps>
84
+<Step>
85
+<StepTitle>Get your API key</StepTitle>
86
+
87
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
88
+
89
+</Step>
90
+<Step>
91
+<StepTitle>Add the MCP server via prompt</StepTitle>
92
+
93
+Copy this prompt and paste it into OpenClaw:
94
+
95
+```
96
+Add a new MCP server called "composio" with transport type HTTP.
97
+Use the URL https://connect.composio.dev/mcp and add the header
98
+"x-consumer-api-key: YOUR_API_KEY".
99
+```
100
+
101
+</Step>
102
+</Steps>
103
+
104
+</ConnectClientOption>
105
+
106
+<ConnectClientOption id="claude-desktop" name="Claude Desktop" description="Anthropic's desktop app" icon="/images/clients/claude.svg" category="popular">
107
+
108
+## Claude Desktop
109
+
110
+<Steps>
111
+<Step>
112
+<StepTitle>Open Connectors settings</StepTitle>
113
+
114
+In Claude Desktop, go to **Settings**, then click **Connectors**.
115
+
116
+</Step>
117
+<Step>
118
+<StepTitle>Add the Composio MCP server</StepTitle>
119
+
120
+Click **Add custom connector** and paste the Composio MCP server URL.
121
+
122
+```
123
+https://connect.composio.dev/mcp
124
+```
125
+
126
+</Step>
127
+<Step>
128
+<StepTitle>Authorize in your browser</StepTitle>
129
+
130
+A browser window will open automatically. Sign in to authorize Claude Desktop to access your Composio account.
131
+
132
+</Step>
133
+</Steps>
134
+
135
+</ConnectClientOption>
136
+
137
+<ConnectClientOption id="chatgpt" name="ChatGPT" description="OpenAI's AI assistant" icon="/images/clients/chatgpt.png" category="other">
138
+
139
+## ChatGPT
140
+
141
+<Steps>
142
+<Step>
143
+<StepTitle>Enable Developer Mode</StepTitle>
144
+
145
+In ChatGPT, go to **Settings > Apps > Advanced settings** and toggle on **Developer Mode**. Requires ChatGPT Plus, Pro, Business, Enterprise, or Edu.
146
+
147
+</Step>
148
+<Step>
149
+<StepTitle>Add the MCP server</StepTitle>
150
+
151
+Click **Create app** and paste the Composio MCP server URL.
152
+
153
+```
154
+https://connect.composio.dev/mcp
155
+```
156
+
157
+</Step>
158
+<Step>
159
+<StepTitle>Authorize in your browser</StepTitle>
160
+
161
+A browser window will open automatically. Sign in to authorize ChatGPT to access your Composio account.
162
+
163
+</Step>
164
+</Steps>
165
+
166
+</ConnectClientOption>
167
+
168
+<ConnectClientOption id="cursor" name="Cursor" description="AI-powered IDE" icon="/images/clients/cursor.svg" category="other">
169
+
170
+## Cursor
171
+
172
+<Steps>
173
+<Step>
174
+<StepTitle>Get your API key</StepTitle>
175
+
176
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
177
+
178
+</Step>
179
+<Step>
180
+<StepTitle>Add the Composio server</StepTitle>
181
+
182
+Open `.cursor/mcp.json` in your project root (or `~/.cursor/mcp.json` for global config) and add:
183
+
184
+```json title=".cursor/mcp.json"
185
+{
186
+ "mcpServers": {
187
+ "composio": {
188
+ "url": "https://connect.composio.dev/mcp",
189
+ "headers": {
190
+ "x-consumer-api-key": "YOUR_API_KEY"
191
+ }
192
+ }
193
+ }
194
+}
195
+```
196
+
197
+</Step>
198
+<Step>
199
+<StepTitle>Restart Cursor</StepTitle>
200
+
201
+Restart Cursor. Composio tools are now available in Composer and Agent mode.
202
+
203
+</Step>
204
+</Steps>
205
+
206
+</ConnectClientOption>
207
+
208
+<ConnectClientOption id="notion" name="Notion" description="AI-powered workspace with custom agents" icon="/images/clients/notion.svg" category="other">
209
+
210
+## Notion
211
+
212
+<Steps>
213
+<Step>
214
+<StepTitle>Get your API key</StepTitle>
215
+
216
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
217
+
218
+</Step>
219
+<Step>
220
+<StepTitle>Create a custom agent</StepTitle>
221
+
222
+In Notion, open the AI agent builder and click **Create Blank** to start a new agent.
223
+
224
+</Step>
225
+<Step>
226
+<StepTitle>Add a connection</StepTitle>
227
+
228
+Click **Add Connection**, then select **Custom MCP**.
229
+
230
+</Step>
231
+<Step>
232
+<StepTitle>Configure the server</StepTitle>
233
+
234
+Enter the MCP server URL:
235
+
236
+```
237
+https://connect.composio.dev/mcp
238
+```
239
+
240
+Select **API Key** as the authentication type. Set the key to `x-consumer-api-key` and paste your API key as the value.
241
+
242
+</Step>
243
+</Steps>
244
+
245
+</ConnectClientOption>
246
+
247
+<ConnectClientOption id="vscode" name="VS Code" description="GitHub Copilot with MCP" icon="/images/clients/vscode.svg" category="ide">
248
+
249
+## VS Code
250
+
251
+<Steps>
252
+<Step>
253
+<StepTitle>Get your API key</StepTitle>
254
+
255
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
256
+
257
+</Step>
258
+<Step>
259
+<StepTitle>Add the Composio server</StepTitle>
260
+
261
+Open or create `.vscode/mcp.json` in your project root and add the following. Requires VS Code 1.99+ with GitHub Copilot.
262
+
263
+```json title=".vscode/mcp.json"
264
+{
265
+ "servers": {
266
+ "composio": {
267
+ "type": "http",
268
+ "url": "https://connect.composio.dev/mcp",
269
+ "headers": {
270
+ "x-consumer-api-key": "YOUR_API_KEY"
271
+ }
272
+ }
273
+ }
274
+}
275
+```
276
+
277
+Note: VS Code uses `"servers"` instead of `"mcpServers"`.
278
+
279
+</Step>
280
+<Step>
281
+<StepTitle>Open a Copilot chat</StepTitle>
282
+
283
+Open a GitHub Copilot chat. Composio tools are now available.
284
+
285
+</Step>
286
+</Steps>
287
+
288
+</ConnectClientOption>
289
+
290
+<ConnectClientOption id="windsurf" name="Windsurf" description="AI-powered IDE" icon="/images/clients/windsurf.svg" category="ide">
291
+
292
+## Windsurf
293
+
294
+<Steps>
295
+<Step>
296
+<StepTitle>Get your API key</StepTitle>
297
+
298
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
299
+
300
+</Step>
301
+<Step>
302
+<StepTitle>Open your MCP config</StepTitle>
303
+
304
+Open `~/.codeium/windsurf/mcp_config.json`, or go to **Windsurf > Settings > MCP Configuration**.
305
+
306
+</Step>
307
+<Step>
308
+<StepTitle>Add the Composio server</StepTitle>
309
+
310
+```json title="mcp_config.json"
311
+{
312
+ "mcpServers": {
313
+ "composio": {
314
+ "serverUrl": "https://connect.composio.dev/mcp",
315
+ "headers": {
316
+ "x-consumer-api-key": "YOUR_API_KEY"
317
+ }
318
+ }
319
+ }
320
+}
321
+```
322
+
323
+Note: Windsurf uses `"serverUrl"` instead of `"url"`.
324
+
325
+</Step>
326
+<Step>
327
+<StepTitle>Restart Windsurf</StepTitle>
328
+
329
+Restart Windsurf. Composio tools are now available in Cascade.
330
+
331
+</Step>
332
+</Steps>
333
+
334
+</ConnectClientOption>
335
+
336
+<ConnectClientOption id="cline" name="Cline" description="VS Code extension" icon="/images/clients/cline.svg" category="ide">
337
+
338
+## Cline
339
+
340
+<Steps>
341
+<Step>
342
+<StepTitle>Get your API key</StepTitle>
343
+
344
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
345
+
346
+</Step>
347
+<Step>
348
+<StepTitle>Open MCP settings</StepTitle>
349
+
350
+In VS Code with Cline installed, click the **MCP Servers** icon in the Cline navigation bar. Click the **Configure** tab, then click **Configure MCP Servers** to open the JSON config file.
351
+
352
+</Step>
353
+<Step>
354
+<StepTitle>Add the Composio server</StepTitle>
355
+
356
+```json title="cline_mcp_settings.json"
357
+{
358
+ "mcpServers": {
359
+ "composio": {
360
+ "url": "https://connect.composio.dev/mcp",
361
+ "headers": {
362
+ "x-consumer-api-key": "YOUR_API_KEY"
363
+ },
364
+ "disabled": false
365
+ }
366
+ }
367
+}
368
+```
369
+
370
+</Step>
371
+<Step>
372
+<StepTitle>Save</StepTitle>
373
+
374
+Save the configuration. Composio tools are now available in Cline.
375
+
376
+</Step>
377
+</Steps>
378
+
379
+</ConnectClientOption>
380
+
381
+<ConnectClientOption id="agent-builder" name="Agent Builder" description="OpenAI Agent Builder" icon="/images/clients/chatgpt.png" category="other">
382
+
383
+## Agent Builder
384
+
385
+<Steps>
386
+<Step>
387
+<StepTitle>Get your API key</StepTitle>
388
+
389
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
390
+
391
+</Step>
392
+<Step>
393
+<StepTitle>Create a new agent</StepTitle>
394
+
395
+Open the [OpenAI Agent Builder](https://platform.openai.com/agent-builder) and create a new agent.
396
+
397
+</Step>
398
+<Step>
399
+<StepTitle>Add MCP Server</StepTitle>
400
+
401
+Click **MCP** in the sidebar, then click **+ Server**. Paste the URL:
402
+
403
+```
404
+https://connect.composio.dev/mcp
405
+```
406
+
407
+Select **Custom headers**. Add a header with name `x-consumer-api-key` and paste your API key as the value.
408
+
409
+</Step>
410
+</Steps>
411
+
412
+</ConnectClientOption>
413
+
414
+<ConnectClientOption id="n8n" name="n8n" description="Workflow automation" icon="/images/clients/n8n.svg" category="other">
415
+
416
+## n8n
417
+
418
+<Steps>
419
+<Step>
420
+<StepTitle>Get your API key</StepTitle>
421
+
422
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
423
+
424
+</Step>
425
+<Step>
426
+<StepTitle>Add an MCP Client node</StepTitle>
427
+
428
+In your n8n workflow, add an **MCP Client** node or MCP Client Tool sub-node for AI agent chains.
429
+
430
+</Step>
431
+<Step>
432
+<StepTitle>Configure the connection</StepTitle>
433
+
434
+Set the connection type to **HTTP Streamable** and paste the server URL:
435
+
436
+```
437
+https://connect.composio.dev/mcp
438
+```
439
+
440
+Select **Header Auth** and create a new credential. Set the header name to `x-consumer-api-key` and paste your API key as the value.
441
+
442
+</Step>
443
+</Steps>
444
+
445
+</ConnectClientOption>
446
+
447
+<ConnectClientOption id="mcp-url" name="MCP URL" description="For any MCP client" icon="/images/clients/mcp.svg" category="other">
448
+
449
+## MCP URL
450
+
451
+<Steps>
452
+<Step>
453
+<StepTitle>Get your API key</StepTitle>
454
+
455
+Open the [Composio dashboard](https://dashboard.composio.dev) and click **AI Clients** in the sidebar. Select your client and copy your API key.
456
+
457
+</Step>
458
+<Step>
459
+<StepTitle>Add to your client config</StepTitle>
460
+
461
+Use this config with any MCP-compatible client:
462
+
463
+```json
464
+{
465
+ "mcpServers": {
466
+ "composio": {
467
+ "url": "https://connect.composio.dev/mcp",
468
+ "headers": {
469
+ "x-consumer-api-key": "YOUR_API_KEY"
470
+ }
471
+ }
472
+ }
473
+}
474
+```
475
+
476
+</Step>
477
+</Steps>
478
+
479
+</ConnectClientOption>
480
+
481
+</ConnectFlow>
482
+
483
+### Connect your apps
484
+
485
+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.