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.
|