Skip to main content
Integrations connect Komos to external services like Google Sheets, Slack, CRMs, and more. Once connected, Agent Action nodes can call these APIs without you writing any code.

​
How integrations work

  1. Connect once at the org level (Settings > Integrations)
  2. Enable per task to control which automations can access which services
  3. Use in Agent Action by describing what you want to do in plain language
The AI agent handles authentication, API calls, and error handling automatically.

​
Connecting an integration

  1. Open Settings > Integrations from the left navigation
  2. Browse available toolkits or search by name
  3. Click Connect on the service you need
  4. Complete the OAuth flow or enter API credentials
  5. Return to Komos - the connection appears under the toolkit
Connections are org-scoped. All team members can use connected integrations in their tasks.

​
Managing connections

Each toolkit shows its connected accounts:
  • Status: Connected, expired, or needs reauthorization
  • Refresh: Reconnect if credentials expired
  • Add another: Connect multiple accounts of the same service
  • Remove: Disconnect an account

​
Using integrations in tasks

​
Step 1: Enable integrations on the task

In the task wizard or builder:
  1. Open the Integrations panel
  2. Select which connections this task can access
  3. Only selected connections are available at runtime

​
Step 2: Add an Agent Action node

Agent Action is the node type that can call integrations:
  1. Add an Agent Action node
  2. In the prompt, describe the API work:
Using Google Sheets:
1. Open the spreadsheet "Sales Pipeline"
2. Find the sheet "Q1 Deals"
3. Add a new row with:
   - Column A: ${deal_name}
   - Column B: ${deal_value}
   - Column C: Today's date
  1. The agent calls the Google Sheets API automatically

​
Step 3: Define outputs

If you need data back from the integration:
  1. Add outputs to the Agent Action node
  2. Describe what to capture in your prompt:
Using Slack:
1. Fetch the last 10 messages from #sales-alerts
2. Extract any messages containing "urgent"

Output: urgent_messages (list of message texts)

​
Available integrations

Komos supports 100+ integrations via Composio. Common categories:
CategoryExamples
ProductivityGoogle Sheets, Google Docs, Notion, Airtable
CommunicationSlack, Gmail, Microsoft Teams
CRMSalesforce, HubSpot, Pipedrive
Project ManagementJira, Asana, Linear, ClickUp
Dev ToolsGitHub, GitLab, Vercel
StorageGoogle Drive, Dropbox, Box
Browse the full list in Settings > Integrations.

​
Integrations vs browser automation

ApproachBest for
IntegrationsServices with APIs, structured data, bulk operations
Browser automationLegacy systems, sites without APIs, UI-only workflows
Komos picks the right approach automatically. When an API exists, it uses the integration. When no API exists, it falls back to browser automation. You can also combine both in a single task:
  • Use browser automation to log in and navigate
  • Use integrations to update a spreadsheet with extracted data

​
Security

  • OAuth tokens are stored encrypted
  • API keys are encrypted at rest
  • Connections are org-scoped - not shared across organizations
  • Per-task enablement - tasks only access integrations you explicitly allow

​
Troubleshooting

​
”Integration not available”

  • Check that the connection is active in Settings > Integrations
  • Verify the task has the integration enabled
  • Refresh the connection if it shows as expired

​
API errors

  • Review the run logs for the specific error message
  • Check that your account has the required permissions
  • For rate limits, the agent will retry automatically

​
Missing integrations

  • Search for the service name in the Integrations page
  • Contact support if you need a specific integration added