integrations

# Butterbase Integrations (Composio) The `manage_integrations` MCP tool gives every Butterbase app access to Composio's toolkit catalog. **Before installing a third-party SDK for any of the use cases below, check whether Composio covers it.** ## Decision rule ``` User wants: send email / Slack message / create calendar event / post GitHub issue / etc. Step 1: manage_integrations(app_id, action: "list_available", search: "<keyword>") Step 2: If a toolkit covers it → use the Composio path (configure → list_tools → execute_action) Step 3: If no toolkit covers it OR latency is critical → fall back to a direct API call in a function ``` ## Common toolkit map | Use case | Composio toolkit | Replaces | |---|---|---| | Send email | `gmail` | Resend, SendGrid, Postmark, Mailgun | | Read inbox / search | `gmail` | Custom IMAP, Nylas | | Create calendar event | `google_calendar` | Cal.com API, custom OAuth | | Post Slack message | `slack` | Slack Web API | | Create GitHub issue / PR | `github` | Octokit | | Notion page / database row | `notion` | Notion API | | Linear ticket | `linear` | Linear SDK | | HubSpot contact / deal | `hubspot` | HubSpot API | | Salesforce record | `salesforce` | Salesforce REST | Always call `list_available` first — the catalog grows. ## Flow ``` 1. configure: manage_integrations(app_id, action: "configure", toolkit: "gmail", scopes: ["gmail.send"]) 2. list_tools: manage_integrations(app_id, action: "list_tools", toolkit: "gmail") ...