# Loom MCP > Loom (Async Video Messaging) MCP Server lets your AI agent manage all aspects of video communication. Retrieve detailed metadata, track viewer analytics for shared content, and read or add threaded comments on any video timeline—all through natural conversation. It also handles generating raw MP4 download links and updating video properties without opening the web UI. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** asynchronous-video, screencast, video-messaging, workspace-collaboration, viewer-analytics, video-metadata ## Description Your agent handles every damn thing with Loom, so you don't gotta mess around in the web UI. You can manage your entire video workflow—from checking who watched what to cleaning up old files and getting raw media links—all through talking to your AI client. You need an inventory? You can run `list_videos` to get a full rundown of every single screencast you've got in the workspace. For more detail on any specific clip, `get_video` fetches basic metadata right away, giving you things like the title, the total duration, and the permalink for that video. For organizing your library? You can check out what folders exist by running `list_folders`. If a video needs sorting or renaming, you use `update_video`; this lets you change the asset's properties or update its title directly. And if things get messy, there’s `delete_video`, which permanently wipes that screencast from your workspace—it ain't reversible. To really dig into engagement, you've got two key tools. First, run `get_video_analytics` to pull detailed usage data. This tells you exactly which segments of the video viewers watched and gives you the total viewership counts for that content. Second, if you need the full text breakdown, `get_transcript` retrieves the complete written transcript for any given file. Collaboration is simple. You don't gotta open a browser tab to talk about the videos; your agent handles reading, adding, or removing threaded comments directly on the video timeline. For knowing who’s using the workspace, you can call `list_workspace_members` and get a list of every user connected. Beyond basic management, you've got power tools for delivery. You can generate a precise, temporary download link for the raw MP4 file of any video asset. These capabilities let your agent take complete control, letting you update titles and properties using `update_video` while simultaneously pulling analytics or transcripts without ever leaving your chat window. ## Tools ### delete_video Permanently deletes a specific screencast video from your Loom workspace. This action cannot be undone. ### get_transcript Retrieves the full text transcript for any given video file. ### get_video Fetches basic metadata, including title and duration, for a specific Loom video. ### get_video_analytics Retrieves detailed usage data, showing exactly which segments of the video were watched by viewers. ### list_folders Lists all existing organized folders within your Loom workspace for reference and organization. ### list_videos Returns a list of every video currently accessible in the specified Loom workspace. ### list_workspace_members Lists all users who are members of the connected Loom workspace. ### update_video Changes the title or properties of an existing video asset in your library. ## Prompt Examples **Prompt:** ``` List the last 5 videos in my Loom workspace ``` **Response:** ``` I've retrieved the 5 most recent videos. Highlights include 'Product Demo Q1' (ID: vid-123), 'Bug Report: Login Flow' (ID: vid-456), and 'Quick Update' (ID: vid-789). Would you like to see the viewership analytics for the product demo? ``` **Prompt:** ``` Show me the comments for video ID 'vid-123' ``` **Response:** ``` I've found 3 comments on 'Product Demo Q1': 1) Sarah: 'Great overview, can we add more detail on the API?', 2) Alex: 'Looks good!', 3) Mark: 'When is this launching?'. Would you like me to draft a reply to Sarah? ``` **Prompt:** ``` Get the download link for video ID 'vid-456' ``` **Response:** ``` Generating download URL… Done. You can download the raw MP4 file for 'Bug Report: Login Flow' here: [pre-signed-s3-url]. Note that this link is ephemeral and will expire in 1 hour. ``` ## Capabilities ### Retrieve Video Metrics Get detailed viewer data—watch segments and total viewership counts—using the video analytics tool. ### Manage Comments Read, add, or remove threaded comments directly on a video timeline without opening Loom. ### List & Retrieve Video Metadata Fetch titles, durations, permalinks, and transcripts for all videos in your workspace using `list_videos` or `get_video`. ### Download Raw Files Generate a precise, temporary download link for the raw MP4 file of any video. ### Organize Library Assets Update titles or move specific screencasts into target folders using `update_video` and `list_folders`. ## Use Cases ### Auditing a Feature Demo A PM needs to know if the new onboarding flow demo actually hit the 'Payment Setup' screen. They ask their agent to run `get_video_analytics` on the video ID, which returns session telemetry showing exactly how many viewers watched through that critical segment. ### Handling a Support Query A support rep gets asked about comments on an old training video. They prompt their agent to read the timeline using comment tools, instantly surfacing the conversation history without having to navigate deep into Loom's UI threads. ### Cleaning Up Assets The team lead realizes a series of outdated mockups are cluttering the main workspace. They prompt the agent to `list_videos` and then execute `delete_video` on the specific IDs, keeping the library optimized. ### Archiving Content A video needs a title change because the client rebranded. The content owner asks their agent to run `update_video`, changing the asset's name and then moving it into the 'Archive/2024' folder using the API. ## Benefits - Stop guessing what people watched. `get_video_analytics` gives you precise segment telemetry, letting you know exactly where viewers dropped off or spent the most time. - Keep communication flowing without opening a browser. You can read or add threaded comments using your agent, keeping high-touch collaboration right in your chat window. - Handle large libraries efficiently. Use `list_videos` to get an inventory of every asset, and then use `get_video` for the details you need on any specific one. - Access raw content instantly. The server generates ephemeral MP4 download endpoints, letting you grab the physical video file without fighting UI restrictions. - `update_video` lets you maintain library hygiene by renaming or relocating videos in real time, keeping your asset structure clean. ## How It Works The bottom line is, your AI client talks directly to Loom's core APIs so you don't have to use the web interface. 1. Subscribe to this server and provide your Loom API Token. 2. Your AI client sends a natural language request (e.g., 'What did Sarah watch in the Q3 pitch video?'). 3. The agent executes the necessary tools (`get_video`, `get_video_analytics`) and returns the structured data to you. ## Frequently Asked Questions **How do I get detailed metrics using get_video_analytics?** You provide the specific Video ID to the agent, and it runs `get_video_analytics`. This returns session telemetry detailing exactly which watch segments were viewed by users. **Can I delete a video with delete_video?** Yes. The tool uses `delete_video` to permanently remove the screencast from your workspace. Remember, this action is irreversible. **What can list_videos give me?** `list_videos` returns a comprehensive inventory of every video in your workspace. You'll get enough data to start building an asset map or checking for missing content. **How do I make the raw MP4 file? Is there a download link?** You ask the agent to generate an ephemeral download endpoint. It uses its internal mechanism to create a temporary, direct URL you can use to grab the raw MP4. **Can I read comments on a video using get_video_analytics?** No. `get_video_analytics` only handles viewership data (segments watched). To see comments, you need to interact with the comment management tools directly. **How do I change a video's title or move it using update_video?** You use `update_video` to rename content. This tool allows you to modify the video's visible title and properties in real-time without affecting the file itself. You can also relocate specific screencasts into different workspace folders for better organization. **What information does list_workspace_members provide?** It lists every member associated with your Loom workspace. This helps you audit team roles and understand who has access to the content. It returns user profiles, which is useful for managing permissions or knowing key stakeholders. **How do I retrieve a full text copy using get_transcript?** The `get_transcript` tool retrieves the complete spoken word transcript from a video file. It gives you clean, textual data that lets you index or search the content without needing to watch the recording. **Can I see who watched my video using my agent?** Yes. Use the `list_viewer_sessions` tool with a specific Video ID. Your agent will retrieve the viewing telemetry, allowing you to see exactly how many times the video was watched and which specific segments were most engaging. **How do I download a raw MP4 file of a Loom video through a conversation?** The `create_download_url` tool forces the backend to allocate an ephemeral S3 pre-signed URL. Your agent will provide this link, which allows you to stream or download the raw bytes of your video directly. **Can my agent respond to comments on my video timeline?** Absolutely. Use the `add_timeline_comment` tool to post threaded messages directly to the video. Your agent can help you maintain community interaction by drafting and sending replies through natural conversation.