Changeimageto - Free Image Editing tools

ChangeImageTo MCP — Image editing for Cursor, Claude & any MCP client

A production-ready Model Context Protocol (MCP) server for AI-assisted image editing. Give Cursor, Claude Desktop, Windsurf, VS Code MCP, and other MCP hosts 16 tools to remove backgrounds, blur or grayscale backgrounds, change colors, convert formats (PNG/JPEG/WebP/…), upscale, denoise/enhance, run OCR, export PDF, edit text in images (Gemini), clean watermarks, inpaint masked regions, and run bulk resize / convert / quality checks.

Search-friendly aliases: image editing MCP · MCP image tools · background removal MCP · remove background API MCP · photo editing LLM tools · Cursor image MCP · Claude image MCP · batch image processing MCP · image upscaling MCP · OCR MCP server.

The server is a small HTTP client: it forwards requests to the same ChangeImageTo image API used by changeimageto.com. Point it at the hosted backend (default) or at your own deployment of the matching /api/* routes.

Why this repo?

You want… This MCP provides… Remove background / transparent PNG remove_background Portrait / product cutouts category: product or portrait Blur background (bokeh-style) blur_background Grayscale background only grayscale_background Color grading (hue / saturation / brightness / contrast) change_image_color Convert image format convert_image_format Upscale 2× / 3× / 4× upscale_image Sharpen / denoise / deblur enhance_image Strip text from photos remove_text_from_image Remove Gemini watermark remove_gemini_watermark Replace text in an image (AI) edit_text_in_image Image → PDF image_to_pdf Image → text (OCR) image_to_text_ocr Inpaint with a user mask remove_painted_areas Bulk resize / convert / quality bulk_* tools

GitHub topics (repository tags)

GitHub allows 20 topics per repository. This repo’s topics (for search and discoverability):

mcp · model-context-protocol · mcp-server · image-editing · image-processing · background-removal · remove-background · photo-editing · image-tools · cursor · claude · claude-desktop · llm · ai-tools · python · ocr · image-upscaling · inpainting · fastapi · changeimageto

Cursor, Claude Desktop, VS Code — MCP config

Replace paths with yours:

{
 "mcpServers": {
 "changeimageto": {
 "command": "/full/path/to/mcp-changeimageto/.venv/bin/python",
 "args": ["/full/path/to/mcp-changeimageto/server.py"],
 "env": {
 "CHANGEIMAGETO_API_BASE": "https://bgremover-backend-121350814881.us-central1.run.app"
 }
 }
 }
}

Or use the console script after pip install .:

{
 "mcpServers": {
 "changeimageto": {
 "command": "/full/path/to/.venv/bin/mcp-changeimageto"
 }
 }
}

The entrypoint runs mcp.run() (stdio transport).

Environment variables

Variable Default Meaning CHANGEIMAGETO_API_BASE https://bgremover-backend-121350814881.us-central1.run.app API origin (no trailing slash). Matches the backend used by changeimageto.com (the marketing site does not serve /api/* itself). CHANGEIMAGETO_HTTP_TIMEOUT 180 HTTP timeout in seconds. CHANGEIMAGETO_API_TOKEN — Optional Authorization: Bearer header if your self-hosted API requires it.

Image inputs

Each tool accepts image (or a list for bulk tools) as:

• HTTPS URL to an image

• Local file path

• Data URL: data:image/png;base64,...

Responses that are binary (PNG, JPEG, PDF, ZIP) are returned as JSON with data_base64 when the payload is under ~12 MB. Larger outputs omit base64 and include a short notice—use a local API, smaller files, or non-bulk endpoints.

Tools ↔ REST API

MCP tool HTTP remove_background POST /api/remove-bg blur_background POST /api/blur-background grayscale_background POST /api/grayscale-background change_image_color POST /api/change-color convert_image_format POST /api/convert-format upscale_image POST /api/upscale-image enhance_image POST /api/enhance-image remove_text_from_image POST /api/remove-text remove_gemini_watermark POST /api/remove-gemini-watermark edit_text_in_image POST /api/edit-text-in-image image_to_pdf POST /api/image-to-pdf image_to_text_ocr POST /api/image-to-text remove_painted_areas POST /api/remove-painted-areas bulk_resize_images POST /api/bulk-resize bulk_convert_images POST /api/bulk-convert-format bulk_quality_check POST /api/bulk-quality-check

Test-only, blog, analytics, and payment endpoints are not wrapped (by design).

Related

• Product & docs: changeimageto.com

• MCP spec: modelcontextprotocol.io

• Issues & ideas: github.com/vipul510-web/mcp-changeimageto/issues

License

MIT

Install

git clone https://github.com/vipul510-web/mcp-changeimageto.git
cd mcp-changeimageto
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install .

Install from Git without cloning:

pip install git+https://github.com/vipul510-web/mcp-changeimageto.git