Framehood in Claude Code

The Framehood plugin brings Framehood into Claude Code — the terminal CLI, the Claude desktop app's Code, and the IDE extensions. It bundles the MCP connection, a /framehood:create command, and skills, so Claude can generate media out of the box.

Install

Run these two commands in Claude Code — the first adds the marketplace, the second installs the plugin:

/plugin marketplace add Framehood/framehood-plugin
/plugin install framehood@framehood

You'll need a Framehood account.

Authorize

After installing, connect and sign in to the MCP server — otherwise the tools stay locked:

1. Run /mcp.
2. Select framehood in the list.
3. Choose Authenticate and complete the sign-in in the browser tab that opens.

That's it — no API key to paste. The token is scoped to mcp.framehood.ai.

What it adds

• MCP server framehood → https://mcp.framehood.ai/mcp. Claude Code runs the OAuth sign-in on connect.

• /framehood:create — a command for one-line requests:

  /framehood:create a cinematic portrait of a lighthouse keeper as keeper.jpg

  Plugin commands are namespaced by the plugin, so it's /framehood:create, not /create — type /framehood to find it in the slash-command menu.

• framehood skill — teaches Claude the image, video, audio, qa and files tools, uploading local files, the job→poll workflow, choosing a model, prompt improvement, and credits, so natural requests ("make a 5-second clip of waves at sunset") route correctly.

• video-montage skill — assembling finished videos from parts (reels, ads, mini-dramas, mini-docs), with built-in cinematography and editing know-how.

Use it naturally

Once installed and authorized you don't need the command — just ask:

Make me a hero image of a neon-lit alley, 16:9, and upscale it.

Claude picks image(create) then image(upscale), polls each job, and returns the URLs.

Troubleshooting

The tools don't show up. The MCP server isn't connected. Run /mcp, check framehood is listed and shows connected, and authenticate it if it doesn't.

The /framehood:create command doesn't appear. Plugin commands are namespaced — it's /framehood:create, not /create. Type /framehood to find it. If it's still missing right after installing, run /reload-plugins and check /plugin shows framehood enabled. (You rarely need the command anyway — just ask in plain language.)

"Not authenticated", a 401, or a sign-in loop. The OAuth session expired or was never completed. Run /mcp → framehood → Authenticate, and finish the browser sign-in fully before returning.

/plugin install says the plugin or marketplace isn't found. Add the marketplace first, then install — in this order: /plugin marketplace add Framehood/framehood-plugin, then /plugin install framehood@framehood. Check the repo name is exact.

The sign-in tab never opens. Your browser blocked the pop-up. Allow pop-ups and run /mcp → Authenticate again.

"Insufficient credits" or a job is refused. You're out of credits. Check your balance and plan in the Console — see Credits & plans.

A video or training job looks stuck. Long jobs run for minutes and Claude polls them — just ask "check the status". An unknown job id returns no such job rather than a fake status.

Claude forgets your preferences between sessions. Teach it once and ask it to remember; make sure memory and search across chats are enabled in Claude's settings.

Newer models or skills aren't available. Framehood ships updates often. Update the plugin (/plugin → framehood → update, or re-run /plugin install framehood@framehood) and reconnect with /mcp.

See also

Not in Claude Code? Add Framehood to Claude.ai (web, desktop, mobile) as a connector, use the CLI, or connect any MCP client.