Tinify plugin for Claude Code

Image tools for Claude: compression, resizing, cropping, and format conversion via the tinify.dev API. Ships the @tinify-dev/mcp server plus a tinify-images skill that teaches Claude when and how to optimize images.

Install

/plugin marketplace add Stianlars1/tinify-plugin
/plugin install tinify@tinify

Set your API key (free, 500 operations/month, no card - create at tinify.dev/developers):

export TINIFY_API_KEY=tnf_live_...

What you get

• MCP tools: compress_image, resize_image, crop_image, convert_image, get_usage - absolute-path file operations that never silently overwrite sources and report honest byte counts.
• Skill: tinify-images - Claude automatically reaches for it when a task involves making images smaller, converting formats, hitting a byte budget ("under 100 KB"), or batch optimization.

Notes

• Compression never returns a file larger than the input (optimized: false instead of fake wins). Resize/convert report size changes plainly.
• Limits: 40 MB / 50 MP per image, results expire after two hours.
• Not affiliated with Tinify B.V. or TinyPNG.

MIT (c) Stian Larsen

Install the skill in any agent (70+ supported)

The tinify-images skill also works standalone via skills.sh:

npx skills add Stianlars1/tinify-plugin

Codex users

No plugin needed for the MCP tools:

codex mcp add tinify --env TINIFY_API_KEY=tnf_live_... -- npx -y @tinify-dev/mcp