gyazo-mcp-server

What is gyazo-mcp-server?

A TypeScript-based Model Context Protocol server that provides AI assistants with access to Gyazo images. It integrates with the Gyazo API to enable searching, fetching, uploading, and browsing images along with their metadata and OCR data.

How to use gyazo-mcp-server?

Install globally via npm: npm install -g @notainc/gyazo-mcp-server. You must have a Gyazo account and an API access token set as the GYAZO_ACCESS_TOKEN environment variable. For use with Claude Desktop, add the server configuration to claude_desktop_config.json using either npx or Docker.

Key features of gyazo-mcp-server

• List and access Gyazo images via gyazo-mcp:// URIs
• Provides tools for searching, fetching, and uploading images
• Supports full-text search by keyword, title, app, URL, or date range
• Retrieves original image content, metadata, and OCR data
• Upload images with optional title, description, referer, and app name
• Works with various image formats (JPEG, PNG, etc.)

Use cases of gyazo-mcp-server

• Enable an AI assistant to search images by keyword across a user’s Gyazo captures
• Fetch and display the most recent Gyazo image along with its OCR text
• Upload new screenshots or images to Gyazo directly from a chat interface
• Browse and retrieve detailed metadata (title, description, app) for specific images

FAQ from gyazo-mcp-server

What does gyazo-mcp-server do?

It acts as a bridge between AI assistants (via the Model Context Protocol) and the Gyazo image hosting service, allowing assistants to search, fetch, and upload Gyazo images.

How do I install gyazo-mcp-server?

Install it globally using npm: npm install -g @notainc/gyazo-mcp-server. Alternatively, you can build from source or use a Docker image.

What prerequisites are needed?

You need a Gyazo account and a Gyazo API access token. The token must be set in the GYAZO_ACCESS_TOKEN environment variable.

What tools are available?

Four tools: gyazo_search (full-text search), gyazo_image (fetch by ID/URL), gyazo_latest_image (most recent image), and gyazo_upload (upload base64-encoded images with optional metadata).

Can gyazo-mcp-server upload images?

Yes, the gyazo_upload tool accepts base64‑encoded image data and optional metadata, then returns the uploaded image’s permalink URL and ID.