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

# Plugins

> Install plugins for Arro, connect your apps, choose action permissions, and use them in workflows within your current workspace.

Add plugins to give Arro app access and reusable instructions.
Catalog installations follow your account within each workspace.

Open **Plugins** in the workspace sidebar. Selecting a plugin in the desktop dock opens its detail page.

| Tab         | Shows                                         |
| ----------- | --------------------------------------------- |
| Discover    | Plugins you haven't added                     |
| Installed   | Added plugins, including disabled ones        |
| Needs setup | Enabled plugins missing a required connection |

**Needs setup** appears only when needed. Completed plugins move to **Installed**.

## Install a plugin

<Steps>
  <Step title="Review the plugin">
    Select its card to review supported actions and included apps.
    **Show more** expands the action list.
  </Step>

  <Step title="Install">
    Choose **Install plugin**. Complete the provider's authorization or credentials dialog.
    Existing connections are reused.
  </Step>
</Steps>

You can also choose **Install** directly from **Discover**.
Closing authorization leaves the plugin installed. Choose **Continue setup** to finish.

| Status           | What to do                |
| ---------------- | ------------------------- |
| Needs setup      | Connect the required app  |
| Desktop required | Open Audimate on desktop  |
| Preparing        | Wait for preparation      |
| Needs attention  | Open the plugin and retry |
| Disabled         | Turn on **Enabled**       |

## Connect an app

Choose **Connect** in the plugin's settings and follow its authorization guide.
Desktop authorization opens in your system browser. Return to Audimate when it finishes.

Connections belong to your account in the current workspace.
Shared workflows never share your credentials or grant teammates access.

Gmail sends plain-text email and does not read your inbox. Google Calendar reads calendars and events.
For Gmail, approve **Send email on your behalf**, including Google's separate permissions screen after sign-in.

**Required permissions not granted** means setup is incomplete.
Choose **Reconnect** and select the requested permissions.
Changing Arro's action permissions does not grant access at the provider.

Microsoft Teams and SharePoint require a work or school account.
If administrator approval is required, ask your administrator to approve Audimate before reconnecting.

## Included software

Plugin details list included software, versions, sources, and licenses.
Each desktop downloads and verifies its own packages.
Saving an installation on the web does not prepare another device.

Local software runs on the task's computer and follows its approval settings.

## Manage permissions

Open **Settings → Manage connection** on an installed plugin to control each action.

| Permission         | What happens                   |
| ------------------ | ------------------------------ |
| **Always allow**   | Runs without an approval check |
| **Needs approval** | Uses your task approval mode   |
| **Blocked**        | Cannot run                     |

Automatic approval uses the [task safety check](/concepts/desktop-app#approval-modes).
Manual approval asks through a task card, while unattended tasks never wait for one.

Connecting an app does not authorize every action. Sending an email or message still requires your request.

## Disable or uninstall

Turn off **Enabled** to stop using a plugin. Choose **Uninstall** from its header's options menu to remove it.
Synced devices remove its catalog packages, but active tasks keep their selected instructions.

Connected actions require an installed, enabled plugin using that account.
Uninstalling keeps saved authorization. Use **Manage connection** to disconnect or **Disconnect and revoke access** to withdraw access.

Disconnecting affects every plugin using that connection.

## Use plugins in workflows

Save your own reusable instructions in a [workflow](/concepts/workflows).
Type **@** in a playbook to select a catalog plugin, even before installing it.
The workflow identifies prerequisites: install, enable, and connect the required plugins.
Each runner uses their own settings and accounts.

Arro delegates supported plugin actions to background tasks.
If setup is incomplete, it explains what needs attention.
Browser automation remains available for unsupported actions.

## Related

<Columns cols={2}>
  <Card title="Workflows" icon="diagram-project" href="/concepts/workflows">
    Put plugin actions into repeatable work.
  </Card>

  <Card title="Task approvals" icon="desktop" href="/concepts/desktop-app#approval-modes">
    Choose how background tasks receive permission.
  </Card>
</Columns>
