Skip to main content
Glama

Loom MCP Server

License: MIT Python 3.11+

MCP server exposing 59 tools for Loom's internal GraphQL API. Works with Claude, Cursor, or any MCP-compatible client.

Features

  • List, search, and get detailed metadata for Loom videos

  • Read transcripts, captions, AI summaries, chapters, and key takeaways

  • Save any fetched content to disk on demand via save_dir parameter

  • Manage comments, tasks, reactions, and tags

  • Organize with folders, spaces, and watch lists

  • Update video settings, share to spaces, and more

Related MCP server: mcp-video-analyzer

Prerequisites

  • Python 3.11+

  • uv package manager

Setup

Authentication

IMPORTANT

This server uses Loom's internal GraphQL API via a browser session cookie. There is no official API key — you must grab the cookie from your browser.

  1. Open loom.com in your browser

  2. Open DevTools (F12) → Application → Cookies → https://www.loom.com

  3. Copy the value of the connect.sid cookie (starts with s%3A...)

  4. Paste it as LOOM_COOKIE in your MCP client config below, prefixed with connect.sid=

The cookie lasts about 30 days. See Troubleshooting if you get auth errors.

Installation

Pick your MCP client below for the appropriate config. Each uses uvx to install and run directly from GitHub — no clone needed.

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "loom": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/karbassi/loom-mcp.git", "loom-mcp"],
      "env": {
        "LOOM_COOKIE": "connect.sid=s%3A..."
      }
    }
  }
}
claude mcp add loom -- uvx --from git+https://github.com/karbassi/loom-mcp.git loom-mcp

Then set the env var in your shell or .env:

export LOOM_COOKIE="connect.sid=s%3A..."

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "loom": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/karbassi/loom-mcp.git", "loom-mcp"],
      "env": {
        "LOOM_COOKIE": "connect.sid=s%3A..."
      }
    }
  }
}

Add to your VS Code settings (.vscode/mcp.json):

{
  "mcpServers": {
    "loom": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/karbassi/loom-mcp.git", "loom-mcp"],
      "env": {
        "LOOM_COOKIE": "connect.sid=s%3A..."
      }
    }
  }
}
git clone git@github.com:karbassi/loom-mcp.git
cd loom-mcp
uv sync
uv run loom-mcp

Or reference it from any MCP client:

{
  "mcpServers": {
    "loom": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/loom-mcp", "loom-mcp"],
      "env": {
        "LOOM_COOKIE": "connect.sid=s%3A..."
      }
    }
  }
}

Shared HTTP server

By default every client starts its own stdio process. To run one long-lived server that many clients share:

LOOM_COOKIE="connect.sid=s%3A..." LOOM_MCP_TRANSPORT=http LOOM_MCP_PORT=8505 loom-mcp
{
  "mcpServers": {
    "loom": { "type": "http", "url": "http://127.0.0.1:8505/mcp" }
  }
}

The endpoint has no authentication: anything that can connect to it can use every tool with your Loom session, including deleting videos. So:

  • The server only binds to loopback (LOOM_MCP_HOST must be 127.0.0.1, localhost, or ::1). Any local process can still connect, so only use HTTP mode on a machine where every local user and process is trusted with your Loom account.

  • It always turns on FastMCP's Host/Origin protection, which FastMCP leaves off by default. That check only stops DNS-rebinding attacks from web pages. It does not authenticate anyone.

  • To reach it from another machine, put it behind a reverse proxy that controls who can connect: a bearer token, mTLS, an IP allowlist on a private network, or similar. Then add the proxy's hostname to FASTMCP_HTTP_ALLOWED_HOSTS, e.g. FASTMCP_HTTP_ALLOWED_HOSTS='["mcp.example.com"]'. If a browser-based client will call it, also add that client's origin to FASTMCP_HTTP_ALLOWED_ORIGINS, e.g. '["https://mcp.example.com"]'. Never expose the port or the proxy publicly without access control.

File-writing tools (save_dir on the read tools, download_media) write on the server's machine, not the client's, and need absolute paths. See Saving to disk.

Tools

Read (31 tools)

Tools marked with Save accept an optional save_dir parameter — see Saving to disk.

Tool

Description

Save

list_videos

List your videos, sorted by most recent

search_videos

AI-powered semantic search

get_video

Video metadata (name, duration, owner, views)

metadata.json

get_transcript

Full transcript with timestamps and speakers

transcript.txt

get_captions

WebVTT captions with start+end timestamps per cue

captions.vtt

get_summary

AI-generated summary

summary.txt

get_chapters

AI-generated chapters

chapters.txt

get_description

AI-generated detailed description with timestamped sections

description.txt

get_key_takeaways

AI-generated key takeaways

takeaways.txt

get_comments

Comments and replies

comments.txt

get_tasks

AI-generated action items

tasks.txt

get_reactions

Emoji reactions

reactions.txt

get_tags

Video tags

tags.txt

get_backlinks

External references (where the video is shared/embedded)

backlinks.txt

get_meeting_notes

Confluence meeting notes URL

get_confluence_pages

Linked Confluence pages

get_download_url

Signed MP4 download URL

download_media

Download audio or video to a local file (works when MP4 export is disabled; optional start/end trim; needs ffmpeg)

out_path

get_video_details

All-in-one: metadata + transcript + chapters + summary + comments + tasks

details.md + all above

list_folders

List your folders

list_spaces

List your workspaces

get_space

Space details (name, privacy, primary)

search_folders

Search folders by name

get_folder

Folder details

get_last_watch_time

Last timestamp where you stopped watching

get_watch_later_count

Number of videos in your Watch Later list

get_total_videos_count

Total videos created by a user

get_frequent_reactions

Your most-used emoji reaction types

get_comment_reactions

Emoji reactions on a specific comment

get_user

User profile by ID (name, email, company, avatar)

search_workspace_tags

Search tags in your workspace

Write (29 tools)

NOTE

Write tools modify your Loom data. Destructive actions (delete, archive, move) cannot always be undone.

Tool

Description

update_video_name

Rename a video

update_video_description

Update video description

update_video_settings

Update video settings (downloads, comments, etc.)

create_comment

Post a comment (with optional timestamp)

edit_comment

Edit an existing comment

delete_comment

Delete a comment

create_task

Create an action item on a video

update_task

Update the content of an action item

delete_task

Delete an action item

approve_task

Mark a task as approved

respond_to_task

Respond to a task

add_reaction

Add an emoji reaction at a timestamp

delete_reaction

Delete a reaction

add_comment_reaction

React to a comment with an emoji

toggle_following

Follow/unfollow a video

toggle_following_tag

Follow/unfollow a workspace tag

archive_videos

Archive or unarchive videos

duplicate_video

Duplicate a video

delete_video

Permanently delete a video

recover_video

Recover a deleted video from trash

pin_video

Pin or unpin a video in your library

add_to_watch_later

Add to Watch Later list

remove_from_watch_later

Remove from Watch Later list

create_folder

Create a new folder

rename_folder

Rename a folder

delete_folders

Delete folders

move_videos

Move videos to a different folder

move_folders

Move folders into a different parent folder

share_videos_to_spaces

Share videos to one or more spaces

Saving to disk

Most per-video read tools accept an optional save_dir parameter. When provided, the tool saves its output to {save_dir}/{video_id}/ and returns the file path alongside the content. When omitted, nothing is saved.

save_dir (and download_media's out_path) must be an absolute path; ~ is expanded. Relative paths are rejected because they would resolve against the server process's working directory, which means nothing for a shared or launchd-managed server.

Just ask naturally — "get the details from my last meeting and save them to ~/Downloads/loom" — and the LLM will pass save_dir="~/Downloads/loom" to the tool.

get_video_details saves each piece individually (metadata.json, transcript.txt, summary.txt, etc.) plus a combined details.md.

Troubleshooting

Auth errors

If you get auth errors, your connect.sid cookie has expired (~30 days). Grab a fresh one from your browser using the steps in Authentication.

Debugging with MCP Inspector

npx @modelcontextprotocol/inspector uvx --from git+https://github.com/karbassi/loom-mcp.git loom-mcp

Contributing

Issues and pull requests are welcome on GitHub.

License

MIT

Available Tools

60 tools
add_comment_reactionB
Idempotent

Add an emoji reaction to a comment on a Loom video.

Inputs: comment_id (required), reaction (required), comment_type. Returns: result

add_reactionA

Add an emoji reaction to a Loom video at a specific timestamp.

Use get_frequent_reactions to discover valid reaction type values.

Inputs: video_id (required), time (required), reaction_type (required). Returns: result

add_to_watch_laterA
Idempotent

Add a Loom video to your Watch Later list.

Inputs: video_id (required), minutes_from_utc. Returns: result

approve_taskA
Idempotent

Mark an action item (task) as approved on a Loom video.

Inputs: task_id (required). Returns: result

archive_videosB
DestructiveIdempotent

Archive or unarchive Loom videos. Archived videos are hidden but not deleted.

Inputs: video_ids (required), archive. Returns: result

create_commentA

Post a comment on a Loom video. Each call creates a new comment.

Inputs: video_id (required), content (required), timestamp. Returns: result

create_folderA

Create a new Loom folder. Each call creates a new folder.

Inputs: name (required). Returns: result

create_taskA

Create an action item (task) on a Loom video. Each call creates a new task.

Inputs: video_id (required), content (required), timestamp. Returns: result

delete_commentA
DestructiveIdempotent

Delete a comment from a Loom video. This cannot be undone.

Inputs: comment_id (required). Returns: result

delete_foldersB
DestructiveIdempotent

Delete one or more Loom folders. This cannot be undone.

Inputs: folder_ids (required). Returns: result

delete_reactionA
DestructiveIdempotent

Delete an emoji reaction from a Loom video.

Inputs: reaction_id (required). Returns: result

delete_taskA
DestructiveIdempotent

Delete an action item (task) from a Loom video. This cannot be undone.

Inputs: task_id (required). Returns: result

delete_videoA
DestructiveIdempotent

Permanently delete a Loom video. This cannot be undone.

To temporarily remove a video, use archive_videos instead. To recover a recently deleted video, use recover_video.

Inputs: video_id (required). Returns: result

duplicate_videoA

Duplicate a Loom video. Creates a new copy each time.

Inputs: video_id (required). Returns: result

edit_commentA
DestructiveIdempotent

Edit an existing comment on a Loom video. Overwrites the comment text.

Inputs: comment_id (required), video_id (required), content (required). Returns: result

get_captionsA
Read-onlyIdempotent

Get WebVTT captions of a Loom video with start and end timestamps per cue.

Ideal for precise timing analysis. For plain text with speaker names, use get_transcript instead.

Inputs: video_id (required), save_dir. Returns: result

get_chaptersA
Read-onlyIdempotent

Get AI-generated chapter markers with timestamps for a Loom video.

Useful for navigating long videos. For a narrative summary, use get_summary.

Inputs: video_id (required), save_dir. Returns: result

get_comment_reactionsA
Read-onlyIdempotent

Get emoji reactions on a specific comment.

Inputs: comment_id (required), comment_type. Returns: result

get_commentsA
Read-onlyIdempotent

Get comments on a Loom video, including threaded replies and timestamps.

Inputs: video_id (required), save_dir. Returns: result

get_confluence_pagesB
Read-onlyIdempotent

Get Confluence pages linked to a Loom video.

Inputs: video_id (required). Returns: result

get_descriptionA
Read-onlyIdempotent

Get the AI-generated description of a Loom video with timestamped sections and bullet points.

More detailed than get_summary. For a brief 1-2 sentence summary, use get_summary instead.

Inputs: video_id (required), save_dir. Returns: result

get_download_urlA
Read-onlyIdempotent

Get a signed download URL for the MP4 file of a Loom video. The URL is temporary and will expire. If no URL is available, call regenerate_mp4 then retry this tool after ~30 seconds.

Inputs: video_id (required). Returns: result

get_folderA
Read-onlyIdempotent

Get details of a Loom folder including name, visibility, and creator.

Inputs: folder_id (required). Returns: result

get_frequent_reactionsA
Read-onlyIdempotent

Get your most frequently used emoji reaction types.

Also useful to discover valid reaction type values for add_reaction.

Inputs: no named parameters. Returns: result

get_key_takeawaysA
Read-onlyIdempotent

Get AI-generated key takeaways from a Loom video as a bullet list.

For a narrative summary, use get_summary. For a detailed timestamped breakdown, use get_description.

Inputs: video_id (required), save_dir. Returns: result

get_last_watch_timeA
Read-onlyIdempotent

Get the last timestamp (in seconds) where you stopped watching a Loom video.

Inputs: video_id (required). Returns: result

get_meeting_notesA
Read-onlyIdempotent

Get the Confluence meeting notes URL linked to a Loom video.

Inputs: video_id (required). Returns: result

get_reactionsA
Read-onlyIdempotent

Get emoji reactions on a Loom video, including who reacted and at what timestamp.

Inputs: video_id (required), save_dir. Returns: result

get_spaceA
Read-onlyIdempotent

Get details of a Loom space including name, privacy level, and whether it's the primary space.

Inputs: space_id (required). Returns: result

get_summaryA
Read-onlyIdempotent

Get the AI-generated summary of a Loom video (1-2 concise sentences).

For a detailed timestamped breakdown with bullet points, use get_description. For key highlights as a bullet list, use get_key_takeaways. For chapter markers, use get_chapters.

Inputs: video_id (required), save_dir. Returns: result

get_tagsB
Read-onlyIdempotent

Get tags on a Loom video.

Inputs: video_id (required), save_dir. Returns: result

get_tasksA
Read-onlyIdempotent

Get AI-generated action items (tasks) from a Loom video, including assignee, status, and timestamp.

Inputs: video_id (required), save_dir. Returns: result

get_total_videos_countA
Read-onlyIdempotent

Get the total number of videos created by a user.

Inputs: user_id (required). Returns: result

get_transcriptA
Read-onlyIdempotent

Get the full transcript of a Loom video with timestamps and speaker names.

Returns plain text with one line per phrase. For precise start/end timing per cue in WebVTT format, use get_captions instead.

Inputs: video_id (required), save_dir. Returns: result

get_userA
Read-onlyIdempotent

Get a Loom user's profile by their ID — name, email, company, and avatar.

Inputs: user_id (required). Returns: result

get_videoA
Read-onlyIdempotent

Get metadata for a Loom video including name, duration, owner, views, and creation date.

For comprehensive info including transcript, chapters, summary, and comments in one call, use get_video_details instead.

Inputs: video_id (required), save_dir. Returns: result

get_video_detailsA
Read-onlyIdempotent

Get all available information for a Loom video in one call: metadata, transcript, chapters, summary, tasks, and comments.

Use this when you need a complete picture of a video. For just metadata, use get_video.

Inputs: video_id (required), save_dir. Returns: result

get_watch_later_countA
Read-onlyIdempotent

Get the number of videos in your Watch Later list.

Inputs: no named parameters. Returns: result

list_foldersA
Read-onlyIdempotent

List your Loom folders, sorted by most recent.

Inputs: limit. Returns: result

list_spacesA
Read-onlyIdempotent

List your Loom spaces (workspaces).

Inputs: no named parameters. Returns: result

list_videosA
Read-onlyIdempotent

List your Loom videos, sorted by most recent.

Returns video IDs and names. Use get_video for metadata on a specific video, or get_video_details for comprehensive info including transcript and comments.

Inputs: limit. Returns: result

move_foldersB
DestructiveIdempotent

Move one or more Loom folders into a different parent folder.

Inputs: folder_ids (required), destination_folder_id (required). Returns: result

move_videosA
DestructiveIdempotent

Move one or more Loom videos to a different folder.

Inputs: video_ids (required), folder_id (required). Returns: result

pin_videoA
Idempotent

Pin or unpin a Loom video in your library.

Inputs: video_id (required), pinned. Returns: result

recover_videoA
Idempotent

Recover a deleted Loom video from the trash.

Inputs: video_id (required). Returns: result

regenerate_mp4A

Trigger MP4 regeneration for a Loom video. Use this when get_download_url reports that no URL is available. Regeneration is asynchronous — after triggering, wait ~30 seconds then retry get_download_url.

Inputs: video_id (required). Returns: result

remove_from_watch_laterA
DestructiveIdempotent

Remove a Loom video from your Watch Later list.

Inputs: video_id (required). Returns: result

rename_folderB
DestructiveIdempotent

Rename a Loom folder.

Inputs: folder_id (required), name (required). Returns: result

respond_to_taskC
Idempotent

Respond to an action item (task) on a Loom video.

Inputs: task_id (required), responded. Returns: result

search_foldersA
Read-onlyIdempotent

Search your Loom folders by name.

Inputs: query (required). Returns: result

search_videosA
Read-onlyIdempotent

Search Loom videos by keyword. Returns matching video IDs and names.

Inputs: query (required), limit. Returns: result

search_workspace_tagsB
Read-onlyIdempotent

Search for tags in your Loom workspace.

Inputs: query (required). Returns: result

share_videos_to_spacesB
Idempotent

Share one or more Loom videos to one or more spaces.

Inputs: video_ids (required), space_ids (required). Returns: result

toggle_followingA
Idempotent

Follow or unfollow a Loom video to get notifications.

Inputs: video_id (required), follow (required). Returns: result

toggle_following_tagA
Idempotent

Follow or unfollow a tag in your Loom workspace to get notifications.

Inputs: tag (required), follow (required). Returns: result

update_taskA
DestructiveIdempotent

Update the content of an action item (task) on a Loom video.

Inputs: task_id (required), content (required). Returns: result

update_video_descriptionA
DestructiveIdempotent

Update the description of a Loom video. Overwrites the existing description.

Inputs: video_id (required), description (required). Returns: result

update_video_nameA
DestructiveIdempotent

Rename a Loom video. Overwrites the existing name.

Inputs: video_id (required), name (required). Returns: result

update_video_settingsA
DestructiveIdempotent

Update settings on a Loom video such as download_enabled, comments_enabled, etc.

Inputs: video_id (required), settings (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 60 tools

    Disambiguation4/5

    Most tools target distinct aspects of Loom videos (reactions, comments, tasks, folders, etc.), and descriptions clarify differences. However, there is potential confusion between similar tools like add_comment_reaction vs add_reaction, and multiple get_* tools for video details (e.g., get_description, get_summary, get_key_takeaways) require careful reading to differentiate.

    Naming Consistency5/5

    The naming follows a consistent verb_noun pattern (e.g., create_comment, delete_video, get_transcript) with underscores throughout. Verbs like get, list, search, create, delete, update, archive, rename are used predictably, making the tool set easy to navigate.

    Tool Count2/5

    With 60 tools, the count is excessively high for a typical MCP server. While the domain is rich, many tools could be consolidated (e.g., multiple get_* variants for video details). The sheer number overwhelms agents and makes selection harder than necessary.

    Completeness5/5

    The tool set covers nearly all aspects of video management: CRUD for videos, comments, tasks, folders, spaces, reactions, watch later, pinning, archiving, recovering, duplicating, sharing, and more. It also includes advanced features like backlinks, Confluence integration, and caption retrieval. No obvious gaps for the intended purpose.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers