StoryFolder Help

Appearance

Set up Claude ​

Download one file, double-click it, restart Claude. That's the whole setup — there's nothing else to install and no settings to get right.

Download Claude Extension

Not published yet. This download is finished, but there is nowhere to get it from yet. Ask support and we will send you a copy — the rest of these instructions work the same either way.

Before you start ​

  • Claude Desktop 0.10.0 or newer. Check Claude's menu → About. Update first if you're older.
  • StoryFolder installed and open.
  • Works on macOS, Windows and Linux.

Install the extension ​

  1. Download the extension with the button above.
  2. Double-click the downloaded file. Claude opens and offers to install it.
  3. Claude shows a notice that the extension is unverified. That's expected — see below. Continue.
  4. Decide whether you want Read-only. It's a checkbox in the extension's settings, off by default. More on that below.
  5. Confirm the install, then quit and reopen Claude. It won't see StoryFolder until you do.

Check it worked ​

With StoryFolder open, ask Claude:

What projects are in my StoryFolder library?

You should get your real project names back, with shot counts and durations. Then try something more interesting.

If Claude says it has no StoryFolder tools, or that StoryFolder isn't running, see troubleshooting.

About the "unverified" notice ​

You'll see a message saying the extension is from an unverified publisher, with a button to install anyway.

That's expected, and it's about our paperwork rather than the file. We haven't finished setting up the credential that would let Claude confirm it's from us. It's the same extension either way. Click through and continue.

If you'd rather not install something unverified, ChatGPT's Codex route runs the same files without an extension.

Let Claude read, but not edit ​

The extension has one setting: Read-only.

Turn it on and Claude can look at everything and change nothing. Renaming, tagging, adding note fields, importing and exporting all stop being available to it — not hidden, just not offered.

Find it under Settings → Extensions → StoryFolder. Restart Claude after changing it.

There's more on what read-only costs you, and what it doesn't protect against, on the overview.

Using Claude on the web or your phone? ​

Those can't reach it. StoryFolder runs on your computer and answers only to things on that computer, so a browser tab or a phone has no way in. You need Claude Desktop.

If you use Claude Code

You don't need the extension. Point Claude Code at the connector directly:

bash
claude mcp add storyfolder -- node /path/to/StoryFolderDesktop/mcp/src/index.js

Read-only mode is an environment variable here:

bash
claude mcp add storyfolder \
  --env STORYFOLDER_MCP_READ_ONLY=1 \
  -- node /path/to/StoryFolderDesktop/mcp/src/index.js

Claude Code uses whatever node is on your PATH. If yours is managed by nvm, fnm, asdf or volta, use the absolute path from which node instead — see the same note on the ChatGPT page.

Next step ​

→ Things to try