Loom MCP Server

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

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.

<details> <summary><b>Claude Desktop</b></summary>

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..."
      }
    }
  }
}

</details>

<details> <summary><b>Claude Code</b></summary>

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..."

</details>

<details> <summary><b>Cursor</b></summary>

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..."
      }
    }
  }
}

</details>

<details> <summary><b>VS Code</b></summary>

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..."
      }
    }
  }
}

</details>

<details> <summary><b>Local clone</b></summary>

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..."
      }
    }
  }
}

</details>

Tools

Read (30 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
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.

Just ask naturally — "get the details from my last meeting and save them to the ask directory" — and the LLM will pass save_dir="ask" 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