pijusz avatar

Mcp Sanity Images

pijusz/mcp-sanity-images

This server connects Claude to Sanity CMS for image asset management. It exposes five tools: upload_image for single file uploads, upload_and_set to upload and patch a document field in one call, batch_upload for entire directories, list_images to preview what's available, and groq_query to find document IDs before attaching assets. You configure it with your Sanity project ID and either pass a token or let it read from the CLI config at ~/.config/sanity/config.json. It handles PNG, JPG, WebP, GIF, and SVG. Reach for it when you're managing product images, article assets, or any content where Claude needs to move files from your filesystem into Sanity's asset pipeline and reference them in documents.

GitHub stars
1
tools
5
transport
STDIO
last updated
Mar 23, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

upload_imageUpload a single local image to Sanity as an asset

Upload a single local image to Sanity as an asset

No parameter schema in public metadata yet.

upload_and_setUpload an image and patch it onto a document field

Upload an image and patch it onto a document field

No parameter schema in public metadata yet.

batch_uploadUpload all images from a folder as assets

Upload all images from a folder as assets

No parameter schema in public metadata yet.

list_imagesList image files in a directory

List image files in a directory

No parameter schema in public metadata yet.

groq_queryRun a GROQ query (find documents before attaching); optional `perspective` (raw default, published, drafts)

Run a GROQ query (find documents before attaching); optional `perspective` (raw default, published, drafts)

No parameter schema in public metadata yet.

Sponsors

Readme

MCPi sanity-images

MCP server for uploading local images to Sanity CMS.
Lets AI assistants upload files from your filesystem directly into Sanity as image assets.


Quick Start

1. Get your Sanity token

Either set the SANITY_TOKEN env var, or just log in with the Sanity CLI:

npx sanity login

The server reads the token from the Sanity CLI config automatically (~/.config/sanity/config.json on all platforms).

2. Add to Claude Code

claude mcp add sanity-images --scope user --transport stdio \
  -e SANITY_PROJECT_ID=your-project-id \
  -- npx -y mcp-sanity-images@latest

That's it. Restart Claude Code and the tools are available. Every session runs the latest version automatically.

Also works with bunx mcp-sanity-images@latest if you have Bun.

Alternative: standalone binary

Download a pre-built binary from Releases:


View the full README on GitHub

Details

Repository
github.com/pijusz/mcp-sanity-images
Package
mcp-sanity-images
Transport
STDIO
Registry
MCP registry, active

More from pijusz