Composio Remote MCP Gateway
Composio's MCP gateway multiplexes hundreds of SaaS integrations into one endpoint with managed authentication โ connect once, get many apps' tools.
- Provider
- Composio โ
- Source
- https://github.com/composiohq/composio โ
- Categories
- ๐ Multi-App Gateways & Automation
ไธญๆ็ฎไป
Composio ่ฟ็จ MCP ็ฝๅ ณ๏ผ้่ฟๆ็ฎก OAuth ๆด้ฒ 250+ SaaS ๅทฅๅ ท้๏ผGitHubใSlackใNotion ็ญ๏ผ๏ผไธไธช็ซฏ็นๆฏๆๅคๅบ็จๅทฅไฝๆตใ
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"composio": {
"url": "https://mcp.composio.dev/mcp"
}
}
}claude mcp add --transport http composio https://mcp.composio.dev/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"composio": {
"type": "http",
"url": "https://mcp.composio.dev/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://mcp.composio.dev/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"composio": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.composio.dev/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"composio": {
"serverUrl": "https://mcp.composio.dev/mcp"
}
}
}๐งฐ Tools exposed by Composio MCP (3)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| list_active_integrations | ๐ข Read | List app integrations currently connected and active. | โ |
| execute_composio_tool | ๐ Write | Execute a tool from a connected Composio toolkit. | toolName*: stringparams: object |
| initiate_oauth_connection | ๐ Write | Start an OAuth connection flow for a third-party app. | appName*: string |
๐ OAuth 2.1 & Security
- Auth type
- OAuth 2.1
- Dynamic Client Registration
- โ Supported
- PKCE S256
- โ Supported
- Protected resource metadata
- https://mcp.composio.dev/.well-known/oauth-protected-resource (expected location)
๐งฉ Recommended Agent Skills
๐ Guide
Composio MCP โ Remote MCP Server
Composio is an integration layer for agents: instead of wiring each SaaS app's MCP or API yourself, you connect through Composio's gateway and get curated toolkits for GitHub, Slack, Notion and 250+ more apps, with OAuth managed on your behalf. Your exact endpoint URL embeds your Composio project โ the value in this directory is the documented entry point.
Endpoint & Transport
- Endpoint URL:
https://mcp.composio.dev/mcp - Transport: Streamable HTTP
Authentication
Composio MCP uses OAuth 2.1 โ the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow โ PKCE and Dynamic Client Registration, so no manual client setup is needed โ and simply open a browser consent screen.
Available Tools (3)
| Tool | Safety | Description |
|---|---|---|
list_active_integrations |
read | List app integrations currently connected and active. |
execute_composio_tool |
write | Execute a tool from a connected Composio toolkit. |
initiate_oauth_connection |
write | Start an OAuth connection flow for a third-party app. |
Connect in 30 Seconds
Claude Code โ one command:
claude mcp add --transport http composio https://mcp.composio.dev/mcp
Cursor โ add to ~/.cursor/mcp.json:
{ "mcpServers": { "composio": { "url": "https://mcp.composio.dev/mcp" } } }
VS Code โ add to .vscode/mcp.json:
{ "servers": { "composio": { "type": "http", "url": "https://mcp.composio.dev/mcp" } } }
Claude Desktop & stdio clients โ bridge with mcp-remote:
{ "mcpServers": { "composio": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.composio.dev/mcp"] } } }
On first connect your client opens a browser OAuth consent screen โ approve it and tools become available immediately.
Troubleshooting
- 401 Unauthorized on connect โ that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact
WWW-Authenticatechallenge. - "Session expired" / stale
Mcp-Session-Idโ just re-sendinitialize; stateless clients can ignore session headers entirely. - Your usable endpoint includes a project/user segment generated in the Composio dashboard.
- Toolkits must be enabled and connected per app before their tools appear.
๐ How to Connect
- Copy the Composio MCP endpoint URLThe remote endpoint is https://mcp.composio.dev/mcp.
- Add it to your MCP clientClaude Code:
claude mcp add --transport http composio https://mcp.composio.dev/mcp. Cursor: add"composio": { "url": "https://mcp.composio.dev/mcp" }undermcpServersin ~/.cursor/mcp.json. Other clients work similarly. - Complete the OAuth consentOn first connection your client opens a Composio consent screen in the browser. Approve it to grant access; the token is stored by the client and refreshed automatically.
- Verify with the online inspectorPaste https://mcp.composio.dev/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm Composio MCP's 3 tools respond.
โ FAQ
What is the Composio MCP remote MCP endpoint?
The primary endpoint is https://mcp.composio.dev/mcp. It is a hosted gateway server operated by Composio, speaking the Streamable HTTP transport.
How do I authenticate with Composio MCP?
Composio MCP uses OAuth 2.1. When your client first connects it receives a 401 challenge, discovers the authorization server via RFC 9728 metadata, and opens a browser consent screen. Dynamic Client Registration is supported, so compliant clients register themselves automatically.
I'm getting a 401 Unauthorized from Composio MCP โ what's wrong?
A 401 means your client hasn't completed (or has lost) the OAuth authorization. Remove and re-add the server in your client to restart the consent flow, and check that your browser session can reach the provider's login page. If the 401 arrives without a WWW-Authenticate header, run it through our OAuth debugger to see what's missing.
Which MCP clients work with Composio MCP?
Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http composio https://mcp.composio.dev/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, and Claude Desktop via the `mcp-remote` bridge.
What tools does Composio MCP expose?
3 tools are cataloged in this directory โ including `list_active_integrations`, `execute_composio_tool`, `initiate_oauth_connection`. Use our online inspector to fetch the live tool list straight from the endpoint.
๐ Connect Guides
๐ Embed Status Badge in README
Related Servers
Zapier's MCP gateway โ one endpoint that proxies thousands of app actions (Gmail, Slack, Sheets...) as MCP tools with your Zapier-connected accounts.
Pipedream's remote MCP gateway. Run 2,700+ app actions and managed triggers against connected accounts through a single OAuth-protected endpoint.