Skip to content
← Back to release · 2.1.283
Improvements / v2.1.283

Save MCP images to disk

CHANGELOG · original

Improved MCP tool results: images returned by MCP tools are now also saved to a file, so Bash, Read and other tools can open them
Open official changelog ↗

Documentation

Documentation excerpt

Images in tool results

When an MCP tool returns a PNG, JPEG, GIF, or WebP image, Claude sees the image inline in the conversation. The inline copy may be scaled down or compressed to fit the model's image size limits. Claude Code also saves the original bytes to a file in the session's tool-results directory under ~/.claude/projects/ and gives Claude the path. Claude can then crop, convert, or reuse the full-resolution file with tools such as Bash.

If you disable session persistence with --no-session-persistence or CLAUDE_CODE_SKIP_PROMPT_HISTORY, Claude Code writes no image file and Claude receives only the inline copy.

Saving MCP image results to a file requires Claude Code v2.1.283 or later.

Documentation snapshot · 2026-11-20

Change details