Skip to content

Drizzle guides

Drizzle MCP Server: Connect Claude to Drizzle (Setup Guide)

Drizzle has a remote MCP (Model Context Protocol) server. Connect it to Claude and you can ask Claude to generate product images and videos on your own Drizzle account, using your existing credits and daily image allowance. You sign in with OAuth, so there is no API key to copy.

By Drizzle team Updated

MCP server URL

Use this URL in any setup below:

https://www.drizzle.gg/api/mcp

It is a streamable HTTP MCP server with OAuth 2.1 sign-in. The client registers itself automatically, so you can leave any OAuth client ID and secret fields blank.

Connection details
SettingValue
Server URLhttps://www.drizzle.gg/api/mcp
TransportStreamable HTTP
AuthenticationOAuth 2.1 with PKCE and dynamic client registration; sign in with your Drizzle account
OAuth client ID / secretNot needed (leave blank)
Supported clientsclaude.ai, Claude Desktop, Claude Code

Connect from claude.ai or Claude Desktop

  1. You need a Drizzle account. If you don’t have one, create it first, then come back.
  2. In Claude, open Settings → Connectors and choose Add custom connector.
  3. Name it Drizzle and paste https://www.drizzle.gg/api/mcp as the URL. Leave the advanced OAuth fields empty.
  4. Click Add, then Connect. A Drizzle sign-in window opens. Sign in with email or Google.
  5. You land back in Claude, and the Drizzle tools show up under the connector. Turn the connector on in a chat from the tools menu.

On Team and Enterprise plans, an owner may need to allow custom connectors first. Drizzle is added by URL; it is not listed in Claude’s connector directory.

Connect from Claude Code

Add the server from your terminal:

claude mcp add --transport http drizzle https://www.drizzle.gg/api/mcp

Then start Claude Code, run /mcp, choose drizzle and pick Authenticate. Your browser opens the Drizzle sign-in page. After you sign in, Claude Code stores the token and the tools are ready.

What the tools do

The server exposes seven tools. Claude picks them from your request, for example “make a 9:16 product video of this bag on a beach” with an image URL. Claude asks you to approve each tool call before it runs.

Drizzle MCP tools
ToolWhat it doesCost
generate_imageCreates one image, or edits an image you pass as a URL (Nano Banana models)Free within your plan’s daily image allowance; paid images use 1–2 credits each, only if you agree
generate_videoStarts a video from a prompt, a start frame or reference images (Omni Flash or Veo 3.1 Lite/Fast/Quality); can also copy a clip’s motion onto a characterOmni Flash 5–16 credits by length and resolution; Veo 3.1 Lite 11, Fast 22, Quality 109
generate_motion_videoApplies the motion of a reference video to a character image (Kling motion control)5 credits per second of the clip
check_videoCollects a finished video by its job idFree
upscale_imageUpscales a Drizzle-generated image to 2KFree
upscale_videoUpscales a Drizzle-generated video to 1080pFree
check_creditsShows your current credit balanceFree
Costs are the same as in the Drizzle app. Video credits are charged when the render starts and refunded automatically if it fails.

How videos come back

Video generation is asynchronous. generate_video and generate_motion_video return a job id right away. Claude then calls check_video until the video is ready, which usually takes 1–5 minutes (motion videos 5–15). Results come back as links to files on Drizzle’s CDN, so Claude shows a link instead of an inline preview.

Tools take images and videos as public URLs. To use a product photo, upload it somewhere public first, or reuse a link Drizzle returned.

Credits and billing

The MCP server uses the same account, balance and plan as the Drizzle app. There is no separate MCP fee. Ask Claude to “check my Drizzle credits” at any time. See pricing for plans and the daily image allowance.

Security and disconnecting

You never paste a password or API key into Claude. Claude gets a short-lived access token (1 hour) and a refresh token (7 days) for your account only, and every tool call is checked against that token. Sign-in redirects are accepted only for Claude (claude.ai) and local clients on localhost, so another site cannot register a fake app to collect your sign-in.

To disconnect, remove the Drizzle connector in Claude’s Connectors settings, or run claude mcp remove drizzle in Claude Code.

Troubleshooting

  • “invalid_redirect_uri” when connecting: the app is not Claude. Only Claude and local clients are supported right now; ChatGPT and Cursor are not.
  • Signed up during the connect flow and nothing happened: new accounts don’t resume the connection. Click Connect in Claude again; you are already signed in.
  • 401 Unauthorized: the token expired and couldn’t be refreshed. Reconnect the connector, or run /mcp → Authenticate in Claude Code.
  • Not enough credits: check your balance with check_credits and top up on the pricing page.
  • Video still rendering: ask Claude to check the video again in a minute; the job id stays valid.

Frequently asked questions

What is the Drizzle MCP server URL?

https://www.drizzle.gg/api/mcp. Add it as a custom connector in Claude, or run claude mcp add --transport http drizzle https://www.drizzle.gg/api/mcp in Claude Code.

Do I need an API key?

No. You sign in with your Drizzle account through OAuth when you connect. Leave any client ID or secret fields blank.

Does using Drizzle through MCP cost extra?

No. Tool calls use the same credits and daily image allowance as the Drizzle app. Checking credits, collecting videos and upscaling are free.

Which apps can connect?

claude.ai, Claude Desktop and Claude Code. ChatGPT, Cursor and other clients are not supported yet.

Is this the Drizzle ORM MCP?

No. This is Drizzle AI, the image and video generator at drizzle.gg. It is unrelated to the Drizzle ORM database toolkit.

Keep exploring

Put your next idea in motion.

Bring a product photo. Drizzle helps you make the creative.

Start creating