Composio MCP with Claude
Node.js versions below 10 are not supported and may cause issues. Uninstall any older Node.js versions before proceeding.
This guide covers installation, authentication flows, and troubleshooting for MCP tools in Claude Desktop.
Installation
-
Check NodeJS Installation
-
Verify NodeJS is installed on your system:
node -v
-
If not installed, download from nodejs.org.
-
-
Install MCP Tools
- Paste the command generated from the mcp.composio.dev:
-
Verify Installation
- Restart the Claude Desktop app and check installed tools by clicking the “hammer” icon in the Claude chat interface.
Authentication Methods
Composio MCP supports two authentication methods:
OAuth Authentication
- Connection Check: Ask the LLM if there is any active connection with the said app.
- Initiate Connection: If no active connection exists, ask the LLM to initiate a connection.
- Complete Authentication: Click the provided authentication link and complete the OAuth flow in your browser.
- Execute Actions: Once authenticated, the LLM can execute authorized actions.
API Key Authentication
-
Connection Verification: Ask the LLM if there is any active connection with the said app.
-
Initiate Connection: If no active connection exists, ask the LLM to initiate a connection.
-
Request API Key: The LLM initiates a connection and prompts for your API key.
-
Enter Credentials: Paste your API key when prompted in the chat interface.
API key entry will be streamlined in future updates.
-
Execute actions After successful authentication, the tool is ready for use.
Troubleshooting
1. Missing Authentication Link
If the authentication link doesn’t appear in chat:
- Explicitly request the link by asking: “Connect to [App name] first and output the auth link.”
- Or specify: “Run COMPOSIO_INITIATE_CONNECTION for [App name] and output the auth link”
2. Connection Verification Issues
If the LLM skips connection verification and starts executing tools:
- Manually request connection initiation: “Run COMPOSIO_INITIATE_CONNECTION for [app name] and provide the authentication link.”
Important: We are actively working on improving the tool execution flow. These troubleshooting steps are quick solutions to help you get started.