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>
This commit is contained in:
Corey Haines
@@ -0,0 +1,105 @@
|
||||
# Composio Quick Start
|
||||
|
||||
Get MCP access to 500+ marketing tools through a single integration.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Node.js 18+
|
||||
- Claude Code installed
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
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](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:
|
||||
|
||||
```bash
|
||||
npx composio apps list
|
||||
```
|
||||
|
||||
### Expired authentication
|
||||
|
||||
OAuth tokens expire. If a tool stops working, re-authenticate:
|
||||
|
||||
```bash
|
||||
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:
|
||||
|
||||
```bash
|
||||
npx @composio/mcp@latest setup
|
||||
```
|
||||
|
||||
Then restart Claude Code.
|
||||
@@ -0,0 +1,91 @@
|
||||
# Composio Marketing Tools
|
||||
|
||||
Detailed mapping of Composio toolkits to marketing use cases. Organized by the same categories as [REGISTRY.md](../REGISTRY.md).
|
||||
|
||||
## CRM
|
||||
|
||||
| Composio Toolkit | Auth | Key Marketing Actions | Depth |
|
||||
|-----------------|------|----------------------|-------|
|
||||
| `HUBSPOT` | OAuth 2.0 | Get/create contacts, list deals by stage, get company info, manage lists, search contacts by property | Deep |
|
||||
| `SALESFORCE` | OAuth 2.0 | Run SOQL queries, get/create leads, list opportunities, get account details, update records | Deep |
|
||||
|
||||
## Email & SMS
|
||||
|
||||
| Composio Toolkit | Auth | Key Marketing Actions | Depth |
|
||||
|-----------------|------|----------------------|-------|
|
||||
| `ACTIVECAMPAIGN` | API Key | Get contacts, list automations, add contacts to lists, get campaign stats | Medium |
|
||||
| `KLAVIYO` | API Key | Get profiles, list segments, get campaign metrics, add to lists | Medium |
|
||||
| `MAILCHIMP` | OAuth 2.0 | Get audiences, list campaigns, get campaign reports, add subscribers | Deep |
|
||||
| `GMAIL` | OAuth 2.0 | Send emails, search inbox, read messages, manage labels | Deep |
|
||||
|
||||
## Advertising
|
||||
|
||||
| Composio Toolkit | Auth | Key Marketing Actions | Depth |
|
||||
|-----------------|------|----------------------|-------|
|
||||
| `FACEBOOKADS` | OAuth 2.0 | Get campaign insights, list ad sets, get ad performance, read audience data | Medium |
|
||||
| `LINKEDIN` | OAuth 2.0 | Get campaign analytics, list campaigns, get company page stats | Medium |
|
||||
| `GOOGLEADS` | OAuth 2.0 | Get campaign performance, list ad groups, keyword stats | Medium |
|
||||
|
||||
## Productivity & Collaboration
|
||||
|
||||
| Composio Toolkit | Auth | Key Marketing Actions | Depth |
|
||||
|-----------------|------|----------------------|-------|
|
||||
| `GOOGLESHEETS` | OAuth 2.0 | Read/write cells, create sheets, format ranges, append rows | Deep |
|
||||
| `SLACK` | OAuth 2.0 | Send messages, read channels, upload files, search messages | Deep |
|
||||
| `NOTION` | OAuth 2.0 | Read/create pages, query databases, update blocks, search | Deep |
|
||||
| `AIRTABLE` | OAuth 2.0 | List/create/update records, query views, manage tables | Deep |
|
||||
|
||||
## Commerce
|
||||
|
||||
| Composio Toolkit | Auth | Key Marketing Actions | Depth |
|
||||
|-----------------|------|----------------------|-------|
|
||||
| `SHOPIFY` | OAuth 2.0 | Get products, list orders, get customer data, inventory levels | Deep |
|
||||
|
||||
## Analytics
|
||||
|
||||
| Composio Toolkit | Auth | Key Marketing Actions | Depth |
|
||||
|-----------------|------|----------------------|-------|
|
||||
| `GOOGLEANALYTICS` | OAuth 2.0 | Run reports, get real-time data, list properties | Medium |
|
||||
|
||||
## Coverage Depth Guide
|
||||
|
||||
- **Deep** — 20+ actions, covers most common operations, suitable for daily use
|
||||
- **Medium** — 5-20 actions, covers core read operations and some writes
|
||||
- **Shallow** — Under 5 actions, basic read-only access
|
||||
|
||||
## Coverage vs. Native Tools
|
||||
|
||||
This table shows where Composio adds value compared to what's already in the MarketingSkills registry:
|
||||
|
||||
| Tool | Native MCP | Native CLI | Composio MCP | Recommendation |
|
||||
|------|:----------:|:----------:|:------------:|----------------|
|
||||
| HubSpot | - | ✓ | ✓ | **Use Composio** — adds MCP access |
|
||||
| Salesforce | - | ✓ | ✓ | **Use Composio** — adds MCP access |
|
||||
| Meta Ads | - | ✓ | ✓ | **Use Composio** — adds MCP access |
|
||||
| LinkedIn Ads | - | ✓ | ✓ | **Use Composio** — adds MCP access |
|
||||
| Google Sheets | - | - | ✓ | **Use Composio** — only MCP option |
|
||||
| Slack | - | - | ✓ | **Use Composio** — only MCP option |
|
||||
| Notion | - | - | ✓ | **Use Composio** — only MCP option |
|
||||
| Airtable | - | - | ✓ | **Use Composio** — only MCP option |
|
||||
| ActiveCampaign | - | ✓ | ✓ | **Use Composio** — adds MCP access |
|
||||
| Klaviyo | - | ✓ | ✓ | **Use Composio** — adds MCP access |
|
||||
| Shopify | - | ✓ | ✓ | **Use Composio** — adds MCP access |
|
||||
| Gmail | - | - | ✓ | **Use Composio** — only MCP option |
|
||||
| GA4 | ✓ | ✓ | ✓ | **Use native** — deeper coverage |
|
||||
| Stripe | ✓ | ✓ | ✓ | **Use native** — deeper coverage |
|
||||
| Mailchimp | ✓ | ✓ | ✓ | **Use native** — deeper coverage |
|
||||
| Google Ads | ✓ | ✓ | ✓ | **Use native** — deeper coverage |
|
||||
|
||||
## Toolkit Reference
|
||||
|
||||
Each Composio toolkit name maps to its `TOOL_NAME` identifier used in the Composio platform. When searching for available actions, use these exact names:
|
||||
|
||||
```bash
|
||||
# List all actions for a toolkit
|
||||
npx composio actions list --app HUBSPOT
|
||||
|
||||
# Search for specific actions
|
||||
npx composio actions list --app FACEBOOKADS --search "insights"
|
||||
```
|
||||
|
||||
For the full integration guide including setup, pricing, and limitations, see [composio.md](../integrations/composio.md).
|
||||
Reference in New Issue
Block a user