Skip to main content

​
Overview

Composio enables your Junis agents to interact with 200+ third-party applications through secure OAuth connections. Instead of managing API keys and webhooks manually, Composio handles authentication and provides ready-to-use tools for your agents.
Connect once, use everywhere. Your agents get native access to Gmail, Slack, GitHub, Jira, and 200+ more services.
No Code Required: Connect apps through the Junis dashboard. Your agents automatically gain access to the connected tools.

​
Supported Applications

Composio supports 200+ integrations across major categories:

Communication

Gmail, Slack, Microsoft Teams, Discord

Productivity

Google Drive, Notion, Jira, Linear, Asana

Development

GitHub, GitLab, Azure DevOps, Bitbucket

CRM & Sales

Salesforce, HubSpot, Pipedrive

Social Media

Twitter/X, LinkedIn, Instagram

Cloud & Storage

Google Drive, Dropbox, OneDrive

​
Connection Types

​
Personal OAuth

Connect your personal accounts to your agents. Only you have access to these connections.Use cases:
  • Personal Gmail for email workflows
  • Personal GitHub for repository management
  • Individual calendar access
Who can create: Any team member
Priority: When both personal and organization connections exist for the same app, your personal connection takes priority — ensuring your agents use your own credentials for sensitive operations.

​
Setting Up Composio

1

Navigate to Integrations

Go to Team > Integrations in the sidebar.
2

Choose an Application

Browse available integrations and click Connect on the app you want (e.g., Gmail).
3

Authorize via OAuth

You’ll be redirected to the application’s OAuth page. Sign in and grant the requested permissions.
4

Verify Connection

Back in Junis, you’ll see the connection status change to Active.
5

Link to an Agent

Go to Admin > Agents, edit your agent, and add the Composio integration in the Integrations section.

​
How Agents Use Composio Tools

Once an integration is connected and linked to an agent, the agent can use it automatically:

​
Example: Gmail Agent

User: "Check my inbox for any urgent emails from the marketing team."

Agent:
1. Connects to Gmail via Composio
2. Searches for recent emails from marketing team addresses
3. Identifies urgent/flagged messages
4. Summarizes findings for the user

Response: "You have 3 unread emails from the marketing team.
The most urgent is about the Q4 budget deadline tomorrow..."

​
Example: GitHub + Slack Workflow

User: "Review my open PRs and notify the team on Slack."

Agent:
1. Fetches open pull requests from GitHub
2. Analyzes each PR's status and review state
3. Sends a formatted summary to the team's Slack channel

Response: "I found 5 open PRs. Summary posted to #dev-updates on Slack."

​
Example: CRM Data Lookup

User: "Find all deals closing this month in our pipeline."

Agent:
1. Queries the CRM for deals with close dates in the current month
2. Filters by pipeline stage
3. Calculates total expected revenue

Response: "There are 12 deals expected to close this month,
with a total pipeline value of $340K..."

​
Managing Connections

​
Connection Status

StatusMeaning
ActiveConnection is working and available to agents
PendingOAuth authorization not yet completed
ExpiredToken expired — re-authorize to restore access
FailedConnection error — try reconnecting

​
Disconnect an Application

  1. Go to Team > Integrations
  2. Find the active connection
  3. Click Disconnect
Disconnecting an integration immediately removes agent access to that application’s tools. Active workflows using that integration will be affected.

​
Composio via Junis Magic

You can also manage Composio integrations through Junis Magic MCP tools:
ToolPurpose
list_composio_integrationsBrowse available integrations and their status
link_agent_composioConnect an integration to a specific agent
list_composio_connectionsCheck active OAuth connections
get_agent_composio_statusVerify agent’s integration readiness

​
Best Practices

Recommended:
  • Use personal connections for individual accounts (personal Gmail, GitHub)
  • Use organization connections for shared team resources (company Slack, team CRM)
  • Only connect integrations that your agents actually need
  • Regularly review active connections in the Integrations dashboard
  • Grant minimum necessary OAuth permissions (least privilege)
Important:
  • Re-authorize connections promptly when tokens expire
  • Don’t share personal connection credentials with team members — use organization connections for shared access
  • Test integrations after connecting before deploying to production workflows

​
Troubleshooting

Cause: OAuth authorization was not completed.Solution: Click the integration again to re-open the OAuth page and complete authorization.
Cause: Integration not linked to the agent.Solution: Go to Admin > Agents, edit the agent, and add the Composio integration in the Integrations section.
Cause: OAuth tokens have a limited lifespan.Solution: Go to Team > Integrations and re-authorize the connection. The agent will resume access automatically.
Cause: Temporary service issue with the connected application.Solution: Check the application’s status page. If the issue persists, disconnect and reconnect the integration.

MCP Integration

Learn about MCP platforms

Junis Magic

Manage integrations via MCP

Agent System

Configure agents

Slack Integration

Slack-specific setup guide
Need Help? Contact us at contact@junis.ai for assistance with Composio integration setup.