img-mcp is an open-source Model Context Protocol (MCP) server that lets AI agents manipulate and generate images. Core operations run locally via Node.js, while AI generation uses Google's Nano Banana models.

How do I install img-mcp?

You can run img-mcp without installing it via npx: npx -y img-mcp. AI generation requires a Google API key from Google AI Studio; local manipulation does not.

Which MCP hosts work with img-mcp?

img-mcp works with any MCP-compatible host, including Claude Desktop, Cursor, Windsurf, Kimi Code, OpenCode, and OpenAI Codex CLI.

Open-source image MCP server

Give your agents a complete image toolkit

img-mcp is an MCP server that lets agents resize, crop, convert, compress, and edit images locally with Node.js — plus generate images when you want AI. No Docker, no shared keys, no friction.

Get started in 60 seconds Read the docs

MIT licensed Zero install with npx Node.js powered

Illustration of an AI agent workspace with image generation and local Node.js processing

Works with

Claude DesktopCursorWindsurfKimi CodeOpenCodeCodex CLI

Features

A complete image toolkit for agents

From fast local edits to AI-powered generation — one MCP server, zero setup.

Generate images

Text-to-image, image-to-image with reference photos, and transparent-background output — all through one tool call.

Resize & crop

Scale by width, height, percentage, or fit mode. Fast local processing with sharp — no API key needed.

Convert formats

Switch between JPEG, PNG, WebP, AVIF, and GIF locally. Tweak quality to optimize file size.

Transparent backgrounds

Generate clean PNG assets with the background removed, ready for logos, overlays, and product shots.

Reference images

Pass base64 or data-URI images to guide style, subject, and composition across generations.

Batch operations

Apply the same transform to multiple images in one call. Perfect for thumbnails, exports, and asset pipelines.

How it works

From command to edited image in three steps

img-mcp translates your agent's instructions into local image operations or generation calls.

Set up in seconds

No API key is required for local manipulation. Add a Google API key only when you want AI image generation.

Add to your MCP host

Edit or generate images

Tell your agent what to do. img-mcp resizes, converts, crops, or generates images and returns the result.

Quick start

Add to Claude Code in one command

No JSON files, no Docker, no manual config. Just run the CLI.

terminal

# Local image manipulation only (no API key needed)
$ claude mcp add --transport stdio img-mcp -- npx -y img-mcp

# With AI image generation enabled
$ claude mcp add --env GOOGLE_API_KEY=YOUR_KEY --transport stdio img-mcp -- npx -y img-mcp

Roadmap

Where img-mcp is headed

AI generation brought us here. The future is fast, local, non-AI image manipulation built on Node.js.

Shipped

Text-to-image generation

Reference-image generation

Transparent backgrounds

Multiple aspect ratios and sizes

Zero-install usage with npx

Bring-your-own Google API key

Resize & convert (local)

Planned

Crop, rotate & flip

Compress / optimize

Blur & sharpen

Adjustments (brightness, contrast, saturation, etc.)

Filters & effects

Metadata read/write (EXIF, IPTC, XMP)

Batch operations

Watermark / overlay

Collage / montage

Sprite sheet generation

Image comparison

Thumbnails

Animated image support

SVG rasterization

Research

Additional generation providers

Upscale & super-resolution

Inpainting / outpainting

Background replacement

Style transfer & presets

Image analysis feedback loop

Ready to give your agent image superpowers?

Join the open-source community and start manipulating and generating images with img-mcp today.

View on GitHub Read documentation