> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getrilo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations Overview

> Overview of Rilo's integration ecosystem with 1000+ tools via Composio, MCP, and custom integrations.

Rilo provides access to 1000+ integrations through multiple integration methods, allowing you to connect workflows to virtually any service or tool.

## Integration Methods

Rilo supports three main integration methods:

<CardGroup cols={3}>
  <Card title="Pre-built Integrations" icon="plug">
    1000+ integrations via Composio platform
  </Card>

  <Card title="MCP Libraries" icon="server">
    Model Context Protocol servers for custom tools
  </Card>

  <Card title="Custom Integrations" icon="code">
    Connect to any REST API or MCP server
  </Card>
</CardGroup>

## Pre-built Integrations

Rilo provides 1000+ pre-built integrations for popular services via the Composio platform.

### Integration Categories

* **Email Tools**: Gmail, Outlook, Zoho Mail
* **Document & File Management**: Google Docs, Sheets, Drive, Dropbox, OneDrive, Box
* **Communication & Collaboration**: Slack, Discord, Microsoft Teams, Zoom, Telegram, WhatsApp
* **Developer Tools & Infrastructure**: GitHub, GitLab, Jira, AWS, Docker
* **Finance & Accounting**: QuickBooks, Stripe, PayPal, Xero, Shopify, Square
* **Marketing & Social Media**: HubSpot, Mailchimp, Facebook, Instagram, LinkedIn, Twitter
* **Project Management & Productivity**: Asana, Trello, Notion, Monday.com
* **Sales & CRM**: Salesforce, Pipedrive, HubSpot CRM, Zendesk
* **HR & People Operations**: BambooHR, Workday, Gusto
* **Specialized Tools**: Canvas, Fireflies, Gong, Polygon, and more

### Connecting Integrations

1. **Go to Integrations page**: Browse available integrations
2. **Click "Connect"**: Authenticate with the service
3. **Use in workflows**: Integration becomes available as a library

<Info>
  Most Composio integrations use OAuth for authentication. You'll be redirected to authenticate with the service.
</Info>

## MCP Libraries

Model Context Protocol (MCP) servers extend Rilo with custom tools and capabilities.

### What is MCP?

MCP is a protocol for connecting AI applications to external tools and data sources. Rilo supports MCP servers to extend its capabilities beyond standard integrations.

### Adding MCP Servers

1. **Go to Integrations page**: Navigate to MCP section
2. **Add MCP Server**: Provide server URL and authentication
3. **Tools Available**: MCP tools become available as libraries

<Info>
  MCP servers can provide custom tools, data sources, and capabilities not available in standard integrations.
</Info>

## Custom Integrations

Create custom integrations for any REST API or MCP server.

### Custom API Integrations

Connect to any REST API by defining endpoints:

1. **Go to Integrations page**: Navigate to Custom Integrations section
2. **Create Custom Integration**: Select "API" type
3. **Define Endpoints**: Specify API endpoints and methods
4. **Configure Authentication**: Set up API keys, OAuth, etc.
5. **Add Tools**: Add multiple tools to your integration
6. **Generate Library**: Rilo generates a library from your API definition

### Custom MCP Tools

Connect to MCP servers for dynamic tool discovery:

1. **Go to Integrations page**: Navigate to Custom Integrations section
2. **Create Custom Integration**: Select "MCP" type
3. **Configure Server**: Provide MCP server URL and authentication
4. **Discover Tools**: Rilo automatically fetches available tools
5. **Generate Library**: Tools become available as library methods

<Info>
  Custom integrations enable you to connect to internal tools, specialized services, or any REST API or MCP server.
</Info>

## Integration Capabilities

### What Integrations Can Do

✅ **Read data**: Fetch data from services
✅ **Write data**: Create, update, delete records
✅ **Trigger workflows**: Start workflows on events
✅ **Send notifications**: Send messages, emails, etc.
✅ **Process files**: Upload, download, process files
✅ **Automate workflows**: Connect multiple services together

### Integration Limitations

❌ **Single account per workflow**: Cannot use multiple accounts of the same tool in one workflow
❌ **OAuth scopes**: Limited to granted OAuth scopes
❌ **API rate limits**: Subject to service rate limits
❌ **Service availability**: Depends on external service availability

<Warning>
  Each tool integration connects to a single authenticated account. To use multiple accounts, create separate workflows.
</Warning>

## Using Integrations in Workflows

### Via Natural Language

Describe what you want:

```
"Read emails from Gmail and create tasks in Asana"
```

The AI agent automatically:

* Identifies required integrations
* Prompts for connection if needed
* Uses appropriate tools in generated code

### In Generated Code

Integrations are used as libraries:

```python theme={null}
from library.communication_tools_library import CommunicationToolsLibrary
from library.project_management_tools_library import ProjectManagementToolsLibrary

gmail = CommunicationToolsLibrary()
asana = ProjectManagementToolsLibrary()

# Read emails
emails = gmail.read_emails(query="is:unread")

# Create tasks
for email in emails:
    asana.create_task(
        name=email["subject"],
        notes=email["body"]
    )
```

## Integration Management

### Viewing Connected Integrations

* **Integrations page**: See all connected integrations
* **Status indicators**: See which integrations are active
* **Connection details**: View authentication status
* **Tool counts**: See how many tools each integration provides

### Disconnecting Integrations

1. **Go to Integrations page**
2. **Find integration**: Locate the integration to disconnect
3. **Click "Disconnect"**: Remove the connection

<Warning>
  Disconnecting an integration will break workflows that use it. Update workflows before disconnecting.
</Warning>

## Tool Documentation

Rilo provides comprehensive documentation for all available tools:

* **[Email Tools](/integrations/email-tools)** - Gmail, Outlook, Zoho Mail
* **[Document Tools](/integrations/document-tools)** - Google Workspace, Dropbox, OneDrive
* **[Communication Tools](/integrations/communication-tools)** - Slack, Discord, Teams, Zoom
* **[Developer Tools](/integrations/developer-tools)** - GitHub, GitLab, Jira
* **[Finance Tools](/integrations/finance-tools)** - QuickBooks, Stripe, PayPal
* **[Marketing Tools](/integrations/marketing-tools)** - HubSpot, Mailchimp, Social Media
* **[Project Management Tools](/integrations/project-management-tools)** - Asana, Trello, Notion
* **[Sales & CRM Tools](/integrations/sales-crm-tools)** - Salesforce, Pipedrive, Zendesk
* **[HR Tools](/integrations/hr-tools)** - BambooHR, Workday, Gusto
* **[Specialized Tools](/integrations/specialized-tools)** - Canvas, Fireflies, Gong

Each tool documentation page includes:

* Available functions/actions
* Available triggers
* Authentication requirements
* Usage examples
* Best practices

## Best Practices

<AccordionGroup>
  <Accordion title="Connect Only What You Need">
    Connect integrations only when needed. Too many connections can be hard to manage.
  </Accordion>

  <Accordion title="Review Permissions">
    Review OAuth scopes when connecting. Only grant necessary permissions.
  </Accordion>

  <Accordion title="Test Integrations">
    Test integrations in workflows before deploying to production.
  </Accordion>

  <Accordion title="Monitor Usage">
    Monitor integration usage and API rate limits to avoid issues.
  </Accordion>

  <Accordion title="Use Custom Integrations">
    Create custom integrations for internal APIs or specialized services not available in Composio.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Integration not connecting">
    * Verify credentials are correct
    * Check OAuth permissions
    * Ensure service is accessible
    * Try disconnecting and reconnecting
  </Accordion>

  <Accordion title="Integration not available in workflow">
    * Verify integration is connected
    * Check integration is active
    * Ensure correct library name is used
    * Refresh workflow editor
  </Accordion>

  <Accordion title="API rate limits">
    * Implement rate limiting in workflows
    * Use caching to reduce API calls
    * Contact service provider for higher limits
    * Consider upgrading integration plan
  </Accordion>

  <Accordion title="Custom integration not working">
    * Verify API base URL is correct
    * Check authentication credentials
    * Test API endpoint directly
    * Review API documentation
  </Accordion>
</AccordionGroup>

## Related Documentation

* [MCP Libraries](/integrations/mcp-libraries) - Detailed guide on MCP integration
* [Custom Integrations](/integrations/custom-integrations) - Creating custom API and MCP integrations
* [Email Tools](/integrations/email-tools) - Email integration tools
* [Document Tools](/integrations/document-tools) - Document management tools

***

<Note>
  Rilo's integration ecosystem is continuously growing. New integrations are added regularly. Check the Integrations page for the latest additions.
</Note>