Gif Creator MCP

What ananddtyagi/gif-creator-mcp MCP server does

The ananddtyagi/gif-creator-mcp MCP server exposes video-to-GIF conversion through MCP. Its main operation, convert_video_to_gif, reads a video from a path supplied by the client and writes a GIF in the same directory. The generated file uses the source video's filename with a .gif extension.

This is suited to workflows that need an agent to turn recorded clips, demonstrations, or other local video files into GIF animations without manually invoking a conversion command. The server can process an entire video or a selected time range.

How it works

A client calls the conversion tool with the required video_path parameter. Optional values control the output:

• fps sets the frame rate and accepts values from 1 to 30; the default is 10.
• width and height set output dimensions. If only one is provided, the other dimension maintains the video's aspect ratio.
• start_time selects the beginning of the source segment in seconds and defaults to 0.
• duration limits the converted segment; if omitted, the server processes the full video.

The ananddtyagi/gif-creator-mcp MCP server uses FFmpeg for media processing and applies optimized palette generation for the GIF output. Longer or larger videos can take more time to convert.

Setup and configuration

The project is distributed as source code and requires Node.js. Install its npm dependencies with npm install, then compile the project with npm run build. The resulting server entry point is dist/index.js, which clients start with Node.js.

A client configuration needs to run node with the built dist/index.js file as its argument. The README shows this pattern for MCP clients and recommends increasing the client timeout to 1000 for this tool. The path in that example must be replaced with the actual location of the checked-out project.

FFmpeg is supplied through the @ffmpeg-installer/ffmpeg dependency, so a separate system FFmpeg installation is not listed as a requirement. No API key, OAuth flow, or external service credential is documented.

Tools and capabilities

The server provides one documented tool:

• convert_video_to_gif: Converts a video file to a GIF and stores the result beside the input.

The tool supports common video-file paths and accepts examples using MP4 and MOV inputs. A basic call only needs the source path. More targeted calls can combine a frame rate, output width, start offset, and duration—for example, extracting a five-second section beginning 30 seconds into a longer recording.

Limitations and notes

The README states that Claude Desktop does not currently support video input for this use case and recommends using another client, such as Goose, as an extension instead. This project does not document a hosted endpoint or a remote execution mode; the described setup runs the built Node.js entry point.

Output is written automatically to the input video's directory, rather than to a separately selected destination. The documentation does not describe controls for output naming, palette parameters, audio handling, or batch conversion. Processing time may increase for large source videos, and clients may need a longer timeout for those jobs.

The repository is licensed under MIT. The ananddtyagi/gif-creator-mcp MCP server is therefore most relevant when the agent and the source video are available in an environment where the Node.js process can access the requested file path.