Tools & Integrations

Overview

Tools & Integrations is the central hub for connecting third‑party apps and managing internal tools that your agents can use at runtime.

Explore

Integrations

Agent Apps (Integrations)

Connect enterprise‑grade applications (e.g., Gmail, Google Drive, HubSpot, Slack) via OAuth to enable agent actions.

1. Connect

   Click Connect on an app and complete OAuth.

2. Configure

   Optionally adjust scopes, triggers, and action availability.

3. Use in Agents

   Connected services become available as tools for your agents.

Connect your Account

1. Go to Integrations
2. Click Connect on the desired service
3. Complete the OAuth flow and grant scopes
4. Copy your Enterprise Token from Integration Settings

Install Integration Tools

To use the integrations locally, you need to install the latest crewai-tools package.

uv add crewai-tools

Environment Variable Setup

Note

To use integrations with Agent(apps=[]), you must set the CREWAI_PLATFORM_INTEGRATION_TOKEN environment variable with your Enterprise Token.

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

Or add it to your .env file:

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

Usage Example

Tip

Use the new streamlined approach to integrate enterprise apps. Simply specify the app and its actions directly in the Agent configuration.

from crewai import Agent, Task, Crew

# Create an agent with Gmail capabilities
email_agent = Agent(
    role="Email Manager",
    goal="Manage and organize email communications",
    backstory="An AI assistant specialized in email management and communication.",
    apps=['gmail', 'gmail/send_email']  # Using canonical name 'gmail'
)

# Task to send an email
email_task = Task(
    description="Draft and send a follow-up email to john@example.com about the project update",
    agent=email_agent,
    expected_output="Confirmation that email was sent successfully"
)

# Run the task
crew = Crew(
    agents=[email_agent],
    tasks=[email_task]
)

# Run the crew
crew.kickoff()

Filtering Tools

from crewai import Agent, Task, Crew

# Create agent with specific Gmail actions only
gmail_agent = Agent(
    role="Gmail Manager",
    goal="Manage gmail communications and notifications",
    backstory="An AI assistant that helps coordinate gmail communications.",
    apps=['gmail/fetch_emails']  # Using canonical name with specific action
)

notification_task = Task(
    description="Find the email from john@example.com",
    agent=gmail_agent,
    expected_output="Email found from john@example.com"
)

crew = Crew(
    agents=[gmail_agent],
    tasks=[notification_task]
)

On a deployed crew, you can specify which actions are available for each integration from the service settings page.

Scoped Deployments (multi‑user orgs)

You can scope each integration to a specific user. For example, a crew that connects to Google can use a specific user’s Gmail account.

Tip

Useful when different teams/users must keep data access separated.

Use the user_bearer_token to scope authentication to the requesting user. If the user isn’t logged in, the crew won’t use connected integrations. Otherwise it falls back to the default bearer token configured for the deployment.

Catalog

Communication & Collaboration

• Gmail — Manage emails and drafts
• Slack — Workspace notifications and alerts
• Microsoft — Office 365 and Teams integration

Project Management

• Jira — Issue tracking and project management
• ClickUp — Task and productivity management
• Asana — Team task and project coordination
• Notion — Page and database management
• Linear — Software project and bug tracking
• GitHub — Repository and issue management

Customer Relationship Management

• Salesforce — CRM account and opportunity management
• HubSpot — Sales pipeline and contact management
• Zendesk — Customer support ticket management

Business & Finance

• Stripe — Payment processing and customer management
• Shopify — E‑commerce store and product management

Productivity & Storage

• Google Sheets — Spreadsheet data synchronization
• Google Calendar — Event and schedule management
• Box — File storage and document management

…and more to come!

Internal Tools

Internal Tools

Create custom tools locally, publish them on CrewAI AMP Tool Repository and use them in your agents.

Tip

Before running the commands below, make sure you log in to your CrewAI AMP account by running this command: bash crewai login

1. Create

   Create a new tool locally. bash crewai tool create your-tool

2. Publish

   Publish the tool to the CrewAI AMP Tool Repository. bash crewai tool publish

3. Install

   Install the tool from the CrewAI AMP Tool Repository. bash crewai tool install your-tool

Manage:

• Name and description
• Visibility (Private / Public)
• Required environment variables
• Version history and downloads
• Team and role access

Related

Tool Repository

Create, publish, and version custom tools for your organization.

Webhook Automation

Automate workflows and integrate with external platforms and services.