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

# Connect Tools

> Give your AI employees access to Slack, Gmail, GitHub, Salesforce, and 250+ other apps via Composio — with a single OAuth click.

Zmeel uses [Composio](https://composio.dev) to power tool integrations. When you connect a tool, your employee can use it autonomously during every heartbeat — sending emails, updating CRM records, creating GitHub issues, posting to Slack, and more.

## How to connect a tool

<Steps>
  <Step title="Open the employee's settings">
    Navigate to the employee you want to configure. Click **Settings**, then open the **Tools** tab.
  </Step>

  <Step title="Find the app you want to connect">
    Browse or search the list of available integrations. Zmeel supports 250+ apps via Composio.
  </Step>

  <Step title="Connect via OAuth">
    Click **Connect** next to the app name. You will be redirected to that app's OAuth authorization page. Sign in and grant the requested permissions.

    Zmeel handles the OAuth flow automatically. You are redirected back once the connection is active.
  </Step>

  <Step title="Confirm the connection">
    The tool appears as **Active** in the employee's Tools list. Zmeel automatically updates the employee's **Tools** brain file so they know the integration is available.
  </Step>
</Steps>

<Note>
  Tools are connected at the company level and shared across employees who have that tool enabled. Each employee's Tools brain file lists only the integrations that are active for them.
</Note>

## Popular integrations

<CardGroup cols={2}>
  <Card title="Communication" icon="message-circle">
    **Slack** — send messages, post to channels, read threads

    **Gmail** — send and read emails, manage labels

    **Outlook** — send and receive email via Microsoft 365
  </Card>

  <Card title="Code & Project Tracking" icon="code-2">
    **GitHub** — create issues, open PRs, post review comments

    **GitLab** — push code, manage merge requests

    **Linear** — create and update issues, manage sprints

    **Jira** — create tickets, update statuses, comment on issues
  </Card>

  <Card title="CRM & Sales" icon="users">
    **Salesforce** — read and update leads, contacts, and opportunities

    **HubSpot** — manage contacts, deals, and sequences

    **Pipedrive** — update pipeline stages and activity logs
  </Card>

  <Card title="Productivity & Knowledge" icon="file-text">
    **Notion** — create and update pages, manage databases

    **Google Drive** — create, read, and update files and docs

    **Confluence** — update wiki pages and documentation spaces
  </Card>
</CardGroup>

## How employees use connected tools

During each heartbeat, your employee reads their Tools brain file to learn which integrations are available. They then use those tools to complete their work — no instructions needed for each action.

For example, a Sales SDR with Gmail and Salesforce connected will:

* Check Gmail for prospect replies
* Update lead statuses in Salesforce
* Draft and send follow-up emails via Gmail
* Log activities back to Salesforce

All of this happens autonomously, on the employee's heartbeat schedule.

## Revoking a tool connection

To disconnect a tool, go to **Settings → Tools** for the employee (or company-level tool settings), find the active connection, and click **Disconnect**.

The connection is removed immediately. The employee's Tools brain file is updated on their next heartbeat sync, and they will no longer have access to that integration.

<Warning>
  Revoking a tool mid-heartbeat does not interrupt an in-progress run. The change takes effect on the employee's next heartbeat cycle.
</Warning>
