Corey Haines
869321e949
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>
106 lines
2.5 KiB
Markdown
106 lines
2.5 KiB
Markdown
# 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.
|