FAL Image/Video Server connects MCP-compatible clients like Claude to FAL AI's powerful image and video generation models. It provides seamless AI-driven media creation with automatic local downloads and flexible access options. Key features: - Generate high-quality images and videos using FAL AI's curated model collection - Automatic downloads to your local machine with customizable save locations (defaults to ~/Downloads) - Flexible content access via public URLs, data URLs, or local file paths - Auto-open generated files in your default system viewer for immediate review - Privacy-focused architecture that uses your local FAL API key without sharing data externally - Configurable data URL generation and file size limits for optimal client compatibility

FAL Image/Video MCP Server 🎨🎬

> High-performance MCP server for FAL AI image and video generation with automatic downloads

[](https://www.npmjs.com/package/fal-image-video-mcp) [](https://nodejs.org/) [](LICENSE) [](https://www.typescriptlang.org/) [](https://modelcontextprotocol.io/)

Seamless bridge between FAL AI's powerful image and video generation capabilities and MCP-compatible clients like Claude. All generated content is automatically downloaded to your local machine while providing public URLs, data URLs, and local file paths.

Make Images

Make Videos

🚀 Claude Desktop Setup

Quick Setup

{
  "mcpServers": {
    "fal-image-video": {
      "command": "npx",
      "args": ["-y", "fal-image-video-mcp"],
      "env": {
        "FAL_KEY": "YOUR-FAL-AI-API-KEY"
      }
    }
  }
}

Configuration File Locations

Optimized for Claude Desktop

{
  "mcpServers": {
    "fal-image-video": {
      "command": "npx",
      "args": ["-y", "fal-image-video-mcp"],
      "env": {
        "FAL_KEY": "YOUR-FAL-AI-API-KEY",
        "DOWNLOAD_PATH": "/custom/download/path",
        "ENABLE_DATA_URLS": "true",
        "MAX_DATA_URL_SIZE": "1048576",
        "AUTOOPEN": "false"
      }
    }
  }
}

Environment Variables:

Getting Your FAL API Key

📥 Automatic Downloads

All generated content is automatically saved to your local machine!

Default Behavior:

🎯 Claude Desktop Optimized Response:

{
  "images": [
    {
      "url": "https://fal-storage.../image.jpg",
      "localPath": "/Users/you/Downloads/fal_imagen4_2025-01-06T12-30-45-123Z.jpg",
      "width": 1024,
      "height": 1024
    }
  ],
  "download_path": "/Users/you/Downloads",
  "data_url_settings": {
    "enabled": false,
    "max_size_mb": 2,
    "note": "Data URLs disabled by default for Claude Desktop optimization"
  },
  "autoopen_settings": {
    "enabled": true,
    "note": "Files automatically opened with default application"
  }
}

Why this works better for Claude Desktop:

---

✨ Features

| Category | Features | |---|---| | 🎨 Image Generation | 8 curated models including Imagen 4, FLUX Kontext Pro, Ideogram V3 | | 🎬 Video Generation | 7 text-to-video models including Veo 3, Kling 2.1 Master, Pixverse V4.5 | | 🔄 Image-to-Video | 6 image-to-video models for animating static images | | 📥 Auto Downloads | All content automatically saved locally with custom path support | | 🔗 Triple URL Support | Public URLs, Data URLs, and Local file paths | | 🚀 Universal Execution | Run any FAL model beyond the curated registry | | 🌐 Multi-Transport | stdio (Claude Desktop) + HTTP/SSE (Smithery/Web) | | 🔐 Lazy Authentication | Discover tools without API key, authenticate on use | | ⚡ Performance | TypeScript implementation, async operations, error handling |

---

🚀 Version History

Version 1.0.0