Integrations

External tools the swarm can talk to — issue trackers, chat platforms, error monitoring, email, and more.

Agent Swarm is built to live inside an existing toolchain. Tasks can come in from issue trackers and chat, agent activity flows back as comments and replies, and incidents from observability tools become triage work automatically.

This section is the canonical home for each integration's setup, behavior, and operational notes. As we add more, each one gets its own page with the same shape:

What it does — direction of sync, trigger surfaces, what becomes a swarm task.
Setup — OAuth/app config, env vars, webhooks.
How it works — gates, filters, lifecycle mapping, outbound updates.
Outbound updates — how to push state back to the external system (skill, MCP tool, or API call).
Reference — link to the canonical API docs / SDK.

Supported integrations

Issue trackers

Linear — inbound webhook → swarm tasks. Workflow-state gate plus swarm-ready label override. Outbound updates via the linear-interaction skill.
Jira Cloud — OAuth 3LO + dynamic webhooks. Assignee or @-mention triggers a task; lifecycle events post back as Jira comments.
GitHub — App + webhooks. Issues, PRs, and review threads create or update swarm tasks; the agent comments back inline.
GitLab — token-based webhooks. Merge requests and issues map to swarm tasks the same way GitHub does.

Chat & email

Slack — bot mentions, slash commands, and thread replies. The swarm uses Slack as its primary human-in-the-loop surface.
AgentMail — per-agent inboxes for email-driven workflows.
Composio — managed connected accounts and Tool Router sessions for third-party app tools such as Gmail and GitHub. Prototype access via agent-swarm x composio and swarm_x.
Kapso (WhatsApp) — inbound WhatsApp messages become swarm tasks; agents reply in-thread. Native webhook + outbound send/reply tools, with the kapso-whatsapp skill for media/templates/reactions.

CRM & data

Salesforce — Salesforce MCP connector authenticated via OAuth. Gives agents access to Salesforce's hosted MCP endpoints.
Microsoft Graph — blessed Microsoft 365 OpenAPI connection with delegated OAuth for Teams, Outlook, OneDrive, and user profiles.

Observability

Sentry — error issues become triage tasks.

Search

Serply — Google web, news, and scholar results through a configured API key and the serply-search skill.

Adding a new integration

The page structure under integrations/ is intentionally generic. To add a new one:

Drop a new <provider>.mdx here with the same section layout (What it does → Setup → How it works → Outbound updates → Reference).
Add the page slug to integrations/meta.json.
Cross-link from the supported list above.