How to add Replicate Flux MCP to Claude Desktop

Community server generating images and SVG assets via Replicate's Flux models. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 103★ · stdio · apikey

Claude Desktop config for Replicate Flux MCP

npx -y replicate-flux-mcp

{
  "mcpServers": {
    "replicate-flux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "replicate-flux-mcp"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "<your-replicate-api-token>"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Replicate Flux MCP config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Replicate Flux MCP's tools appear under the 🔌 tools menu.

Before you start

Node.js (run via `npx`; the package is distributed on npm)
A Replicate API token from https://replicate.com/account/api-tokens, set as the REPLICATE_API_TOKEN environment variable
A Replicate account with billing enabled (image generation is pay-per-use)

What Replicate Flux MCP can do in Claude Desktop

generate_image

Generate a single image from a text prompt using Flux Schnell.

generate_multiple_images

Generate images from up to 10 separate prompts in one call.

generate_image_variants

Create 2-10 variants of one prompt via seed or style variation.

generate_svg

Produce an SVG vector graphic from a text description (Recraft V3 SVG).

prediction_list

List recent predictions from your Replicate account.

get_prediction

Fetch details and status for a specific prediction by ID.

run_replicate_model

Run an arbitrary Replicate model (escape hatch beyond Flux).

get_model_schema

Retrieve the OpenAPI input schema for a given Replicate model.

Security

Your Replicate API token incurs per-generation costs and can run arbitrary models on your account; restrict spend limits on Replicate. The server requires the token to be present in env at startup.

Replicate Flux MCP + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Replicate Flux MCP config there under the "mcpServers" key and restart the client.

Is Replicate Flux MCP safe to use with Claude Desktop?

Your Replicate API token incurs per-generation costs and can run arbitrary models on your account; restrict spend limits on Replicate. The server requires the token to be present in env at startup.

Where do I get the API token?

Create a Replicate account and generate a token at https://replicate.com/account/api-tokens, then set it as REPLICATE_API_TOKEN.

Is image generation free?

No. Replicate is pay-per-use, so each generation incurs a small charge billed to your Replicate account.

Can it generate vector graphics, not just PNGs?

Yes. The generate_svg tool produces true SVG output via Recraft's V3 SVG model, which scales cleanly to any size.

View repo Full Replicate Flux MCP page