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

  1. Check NodeJS Installation

    • Verify NodeJS is installed on your system: node -v

    • If not installed, download from nodejs.org.

  2. Install MCP Tools

    $Your generated code
  3. Verify Installation

    • Restart the Claude Desktop app and check installed tools by clicking the “hammer” icon in the Claude chat interface.
Claude MCP Installation

Authentication Methods

Composio MCP supports two authentication methods:

OAuth Authentication

  1. Connection Check: Ask the LLM if there is any active connection with the said app.
  2. Initiate Connection: If no active connection exists, ask the LLM to initiate a connection.
  3. Complete Authentication: Click the provided authentication link and complete the OAuth flow in your browser.
  4. Execute Actions: Once authenticated, the LLM can execute authorized actions.
OAuth Authentication in Claude

API Key Authentication

  1. Connection Verification: Ask the LLM if there is any active connection with the said app.

  2. Initiate Connection: If no active connection exists, ask the LLM to initiate a connection.

  3. Request API Key: The LLM initiates a connection and prompts for your API key.

  4. Enter Credentials: Paste your API key when prompted in the chat interface.

    API key entry will be streamlined in future updates.

  5. Execute actions After successful authentication, the tool is ready for use.

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.