Files
Corey Haines 869321e949 feat: add Composio as integration layer for OAuth-heavy marketing tools
Adds Composio MCP server as an alternative integration method for tools
lacking native MCP support (HubSpot, Salesforce, Meta Ads, LinkedIn Ads,
Google Sheets, Slack, Notion, etc.). Existing CLIs and MCP servers are
unchanged — Composio is additive only.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-13 15:37:59 -07:00
..

Composio Quick Start

Get MCP access to 500+ marketing tools through a single integration.

Prerequisites

  • Node.js 18+
  • Claude Code installed

Install

npx @composio/mcp@latest setup

Verify by running /mcp in Claude Code — composio should appear in the server list.

Connect a Tool

When you ask the agent to use a Composio-backed tool for the first time, it will provide a Connect Link. Open the link in your browser, authorize the app, and you're set. The connection persists across sessions.

You: "Get my top HubSpot contacts"
Agent: "Please connect HubSpot first: https://app.composio.dev/connect/..."
# Click the link → authorize → return to Claude Code
Agent: "Here are your top contacts: ..."

Usage Examples

Pull CRM contacts

"Show me my 10 most recent HubSpot contacts with their deal stages"

Get ad performance

"What's my Meta Ads spend and ROAS for the last 7 days?"

Write to a spreadsheet

"Add a row to my 'Campaign Tracker' Google Sheet with today's LinkedIn Ads metrics"

Cross-tool workflow

"Find Salesforce leads from this week and post a summary in Slack #new-leads"

Available Marketing Tools

See marketing-tools.md for the full list of Composio toolkits mapped to marketing use cases.

Key tools with new MCP access (no native MCP server in this repo):

  • HubSpot — contacts, deals, companies, lists
  • Salesforce — SOQL queries, leads, opportunities
  • Meta Ads — campaigns, ad sets, insights
  • LinkedIn Ads — campaigns, analytics
  • Google Sheets — read, write, create spreadsheets
  • Slack — messages, channels
  • Notion — pages, databases
  • Klaviyo — profiles, lists, campaigns
  • ActiveCampaign — contacts, automations

Troubleshooting

"Tool not found" error

The tool may not be connected yet. Ask the agent to connect it, or run:

npx composio apps list

Expired authentication

OAuth tokens expire. If a tool stops working, re-authenticate:

npx composio connections list    # Find the connection
npx composio connections remove {id}  # Remove it
# Then ask the agent to use the tool again to trigger re-auth

Rate limit errors

Composio has its own rate limits (free: 20K calls/mo, 10 req/sec). If you hit them:

  • Reduce request frequency
  • Upgrade your Composio plan
  • Use native CLI tools for high-volume operations

MCP server not appearing

Re-run the setup command:

npx @composio/mcp@latest setup

Then restart Claude Code.