# Loom MCP Server

MCP server for Loom video platform - manage videos, folders, comments, reactions, transcripts, embeds, and workspaces.

## Features

- 📹 **Video Management** - List, get, update, delete, and duplicate videos
- 📁 **Folder Organization** - Organize videos with nested folder structures
- 💬 **Comments & Reactions** - Threaded comments with timestamp pins and emoji reactions
- 📝 **Transcripts** - Access full video transcripts with search across workspace
- 🔗 **Embeds** - Generate customizable embed codes for websites
- 🏢 **Workspace Management** - Manage workspaces and analytics

## Installation

```bash
npm install
npm run build
```

## Configuration

Set your Loom API key:

```bash
export LOOM_API_KEY='your_api_key_here'
```

## Usage

Run the server:

```bash
npm start
# or
loom-mcp-server
```

Add to Claude Desktop config:

```json
{
  "mcpServers": {
    "loom": {
      "command": "node",
      "args": ["/path/to/loom/dist/index.js"],
      "env": {
        "LOOM_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Available Tools

### Video Tools (5)
- `list_videos` - List videos with workspace/folder filtering, pagination
- `get_video` - Get detailed video metadata, status, URLs, engagement
- `update_video` - Update name, description, privacy, folder, download settings
- `delete_video` - Permanently delete video
- `duplicate_video` - Create copy of video

### Folder Tools (5)
- `list_folders` - List workspace folders with hierarchy
- `get_folder` - Get folder details and video count
- `create_folder` - Create new folder with optional parent
- `update_folder` - Rename or move folder
- `delete_folder` - Delete folder (videos move to root)

### Engagement Tools (6)
- `list_comments` - List video comments with pagination
- `create_comment` - Add comment with optional timestamp and threading
- `update_comment` - Edit comment or mark resolved
- `delete_comment` - Delete comment
- `add_reaction` - Add emoji reaction with optional timestamp
- `remove_reaction` - Remove reaction

### Transcript Tools (2)
- `get_transcript` - Get full transcript with timestamps
- `search_transcripts` - Search across workspace transcripts

### Sharing Tools (1)
- `get_embed_code` - Generate embeddable HTML with customization

### Workspace Tools (3)
- `list_workspaces` - List accessible workspaces
- `get_workspace` - Get workspace details and limits
- `get_workspace_stats` - Get analytics (videos, views, storage)

**Total: 22 tools**

## API Coverage

### Core Entities
- ✅ Videos (list, get, update, delete, duplicate)
- ✅ Folders (list, get, create, update, delete)
- ✅ Comments (list, create, update, delete)
- ✅ Reactions (add, remove)
- ✅ Transcripts (get, search)
- ✅ Embeds (generate code)
- ✅ Workspaces (list, get, stats)

### Features
- ✅ Pagination on all list operations
- ✅ Threaded comments
- ✅ Timestamp-based comments & reactions
- ✅ Nested folder structures
- ✅ Privacy controls
- ✅ Transcript search
- ✅ Embed customization
- ✅ Rate limiting
- ✅ Error handling

## Rate Limits

- Standard: 100 requests/minute
- Automatic rate limit handling with backoff
- Rate limit headers tracked and respected

## Tool Naming Conventions

- `list_*` - Paginated collections (videos, folders, comments, workspaces)
- `get_*` - Single resource retrieval (video, folder, transcript, workspace)
- `create_*` - Resource creation (folder, comment)
- `update_*` - Resource modification (video, folder, comment)
- `delete_*` - Resource deletion (video, folder, comment)
- `add_*` - Adding sub-resources (reaction)
- `remove_*` - Removing sub-resources (reaction)
- `search_*` - Search operations (transcripts)

## Architecture

```
src/
├── index.ts              # MCP server entry point
├── client/
│   └── loom-client.ts    # API client with auth & rate limiting
├── tools/
│   ├── video-tools.ts    # Video management (5 tools)
│   ├── folder-tools.ts   # Folder organization (5 tools)
│   ├── comment-tools.ts  # Comments & reactions (6 tools)
│   ├── transcript-tools.ts # Transcripts & search (2 tools)
│   ├── embed-tools.ts    # Embed generation (1 tool)
│   └── workspace-tools.ts # Workspace management (3 tools)
└── types/
    └── index.ts          # TypeScript interfaces
```

## License

MIT