MCP Directory

How to add Fal.ai MCP Server to Claude Desktop

Community server for image, video, music, and audio generation across fal.ai models. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

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

Claude Desktop config for Fal.ai MCP Server

uvx --from fal-mcp-server fal-mcp
{
  "mcpServers": {
    "fal-ai-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "fal-mcp-server",
        "fal-mcp"
      ],
      "env": {
        "FAL_KEY": "<your-fal-api-key>"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

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

Before you start

  • Python 3.10 or higher (or Docker, or the `uv`/`uvx` package manager for zero-install)
  • A fal.ai API key set as the FAL_KEY environment variable (get it from your fal.ai dashboard; a free tier is available)
  • An MCP client such as Claude Desktop; HTTP/SSE mode additionally needs `mcp-remote` or a compatible web client

What Fal.ai MCP Server can do in Claude Desktop

generate_image

Generate an image from a text prompt across fal.ai image models.

generate_image_structured

Generate an image with structured/controlled parameters.

generate_image_from_image

Image-to-image generation from a source image and prompt.

remove_background

Remove the background from an input image.

upscale_image

Upscale an image to higher resolution.

edit_image

Edit an existing image via prompt-driven changes.

inpaint_image

Inpaint masked regions of an image.

resize_image

Resize an image to target dimensions.

Security

The FAL_KEY bills generation usage to your fal.ai account and can invoke many third-party models; set spend controls and keep the key in env. Generated media may be downloaded locally depending on the model used.

Fal.ai MCP Server + 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 Fal.ai MCP Server config there under the "mcpServers" key and restart the client.

Is Fal.ai MCP Server safe to use with Claude Desktop?

The FAL_KEY bills generation usage to your fal.ai account and can invoke many third-party models; set spend controls and keep the key in env. Generated media may be downloaded locally depending on the model used.

Where do I get the API key?

Sign up at fal.ai and copy your API key from the dashboard, then set it as the FAL_KEY environment variable. A free tier is available to start.

Do I need Node.js?

No, the server is Python (3.10+). You can run it with uvx, pip, or Docker; only the HTTP-via-Docker config example uses npx mcp-remote as the bridge.

Can it do video and music, not just images?

Yes. It exposes generate_video, generate_video_from_image, generate_video_from_video, and generate_music alongside the image tools.

View repo Full Fal.ai MCP Server page