Loom Connector

SKILL.md

---
name: loom-connector
description: "Access Loom video content with managed API key authentication. List, search, and manage Loom videos and their metadata. Use when the user wants to list Loom videos, get video details, search recordings, or access Loom video transcripts."
metadata:
  polly:
    polly_managed_connector: true
    auth:
      - env: LOOM_API_KEY
        type: api_key
        integration_id: loom
        description: Loom API key
    primaryEnv: LOOM_API_KEY
---

# Loom Connector

Access Loom video content through the Loom Developer API using a managed API key.

## First-Time Setup

If Loom is not connected yet, run:

`manage_auth(action="connect", integration_id="loom", auth_env="LOOM_API_KEY")`

## Auth & Security

- Authentication is managed by Polly + Nango from `metadata.polly.auth`
- Never ask users to paste tokens in chat
- Never print or log token values
- If auth fails, reconnect with:
  `manage_auth(action="connect", integration_id="loom", auth_env="LOOM_API_KEY")`

## Base URL

`https://developer.loom.com/v1`

All requests include:

`Authorization: Bearer $LOOM_API_KEY`

> **Note:** Loom API access may require a Business or Enterprise plan. The public API surface is limited compared to other connectors.

## Quick Usage

List videos:

```bash
curl -sS \
  -H "Authorization: Bearer $LOOM_API_KEY" \
  "https://developer.loom.com/v1/videos"
```

Get video details:

```bash
curl -sS \
  -H "Authorization: Bearer $LOOM_API_KEY" \
  "https://developer.loom.com/v1/videos/<videoId>"
```

Get video transcript (if available):

```bash
curl -sS \
  -H "Authorization: Bearer $LOOM_API_KEY" \
  "https://developer.loom.com/v1/videos/<videoId>/transcript"
```

## Rules

- Loom's public API is limited; not all operations available in the UI are exposed via API
- API access requires a Business or Enterprise Loom plan
- On API errors, surface status + response body clearly
- On 401/403, reconnect with:
  `manage_auth(action="connect", integration_id="loom", auth_env="LOOM_API_KEY")`
- Never log, echo, or expose credential values in any output
API_KEY")`
- Never log, echo, or expose credential values in any output