Skip to main content

Set Up CLAD in Cursor

Connect Cursor to Lens Studio through the MCP server and install the CLAD plugin, so Cursor can build and test Lenses in your project.

  • Snapchat: fully supported
  • SPECS: fully supported
  • Camera Kit Web: not supported
  • Camera Kit Mobile: not supported
  • SnapchatFully supported
  • SPECSFully supported
  • Camera Kit WebNot supported — CLAD's skills cover Snapchat and SPECS Lenses
  • Camera Kit MobileNot supported — CLAD's skills cover Snapchat and SPECS Lenses

Platform details

  • Snapchat — Fully supported.

  • SPECS — Fully supported.

  • Camera Kit Web — Not supported — CLAD's skills cover Snapchat and SPECS Lenses.

  • Camera Kit Mobile — Not supported — CLAD's skills cover Snapchat and SPECS Lenses.

Cursor connects to the project you have open in Lens Studio through the Lens Studio MCP server, and the CLAD plugin gives it the agents and skills to build, test, and publish Lenses. Follow these steps in order: Lens Studio has to be running before Cursor opens the project, so Cursor finds its server.

Before you start

Install the CLAD plugin in Cursor

Cursor installs this plugin from a local folder: copy it out of the ls-extensions repository into Cursor's local plugin folder.

  1. In a terminal, clone the ls-extensions repository into a folder outside your Lens Studio project:

    git clone https://github.com/lens-studio-devs/ls-extensions.git
  2. Copy the CLAD plugin into Cursor's local plugin folder.

    On macOS:

    mkdir -p ~/.cursor/plugins/local
    cp -R ls-extensions/plugins/ls-clad ~/.cursor/plugins/local/

    mkdir -p creates any missing folders and doesn't fail if the folder exists.

    On Windows, in PowerShell:

    New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.cursor\plugins\local" | Out-Null
    Copy-Item -Recurse -Force ls-extensions\plugins\ls-clad "$env:USERPROFILE\.cursor\plugins\local"

    -Force lets New-Item succeed when the folder already exists, and lets Copy-Item overwrite an earlier copy; Out-Null hides routine output.

    PowerShell after cloning ls-extensions, beside File Explorer showing the new ls-extensions folder
  3. In Cursor, open the command palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows) and run Developer: Reload Window. If the plugin doesn't appear, quit and reopen Cursor.

To update the plugin later, pull the repository and run the copy command again. Both commands copy into the local folder, so the new files replace the installed ls-clad folder's files. The ls-extensions repository has the latest installation steps, and Plugins in the Cursor documentation covers local plugins.

Open the Lens Studio project in Cursor

  1. In Cursor, select File > Open Folder and choose your Lens Studio project folder. It holds the .cursor/mcp.json file that tells Cursor where this Lens Studio window's server is. If you installed Cursor's command-line tool, you can instead run cursor . in a terminal in the project folder. Cursor also has a command-line agent.
  2. Open Customize in the Cursor sidebar and check that the CLAD plugin is listed.

Turn on the Lens Studio server in Cursor

In Customize, find lens-studio under the MCP servers and turn its toggle on. A disabled server doesn't load in chat. If lens-studio isn't listed or won't connect, see Troubleshoot Lens Studio MCP.

Let Cursor work without asking at every step

A Lens build calls hundreds of tools. In Cursor, open Settings > Agents > Approvals & Execution and choose a run mode:

Run modeWhat it does with Lens Studio tool calls
Auto-reviewRuns allowlisted calls at once, and checks the others automatically
Run EverythingRuns every call without asking

With Auto-review, add lens-studio to the allowlist so Lens Studio tool calls run without waiting for you.

Use Run Everything only in a project you can restore, such as one under version control.

Cursor's Agents settings with Run Mode set to Run Everything

Build a Lens with Cursor and CLAD

Describe the Lens you want in the Cursor agent chat.

When building for SPECS, start the prompt with "Make … for SPECS" so CLAD uses its SPECS Experience Builder:

Make a periodic table Lens for SPECS that shows the atomic structure of each element

Cursor builds the Lens in the open Lens Studio window, so you can watch the scene and Preview change. A full Lens can take 30 minutes or more.