gyazo.com
gyazo.com logo

Gyazo

Integrates with Gyazo to retrieve Gyazo images and metadata, enabling image analysis and content processing.

Created byApr 23, 2025

gyazo-mcp-server

A Model Context Protocol server for Gyazo image integration
This is a TypeScript-based MCP server that provides access to Gyazo images. It allows AI assistants to access and interact with Gyazo images through the Model Context Protocol, providing:
  • Resources representing Gyazo images with URIs and metadata
  • Tools for searching, fetching, and uploading images
  • Image content and metadata access via the Gyazo API

Features

Resources

  • List and access Gyazo images via `gyazo-mcp://` URIs
  • Each image includes: - Original image content - Metadata (title, description, app, URL) - OCR data (if available)
  • Supports various image formats (JPEG, PNG, etc.)

Tools

  • `gyazo_search` - Full-text search for captures uploaded by users on Gyazo - Search by keyword, title, app, URL, or date range - Supports pagination for browsing multiple results - Returns matching image URIs and metadata
  • `gyazo_image` - Fetch image content and metadata from Gyazo - Retrieve specific images by ID or URL - Returns both image content and detailed metadata
  • `gyazo_latest_image` - Fetch the most recent image from Gyazo - Returns both image content and metadata - Includes OCR text if available
  • `gyazo_upload` - Upload an image to Gyazo - Upload images with base64 encoded image data - Add optional metadata like title, description, referer URL, and app name - Returns the uploaded image's permalink URL and ID

Installation

NPM Package

The easiest way to install the Gyazo MCP server is via npm:

Prerequisites

  • Create a Gyazo account if you don't have one: https://gyazo.com
  • Get your Gyazo API access token from: https://gyazo.com/api - Click "Register applications" button - Click "New Application" button - Fill in the form with your app name and description - Name and Callback URL are required - You can use `http://localhost` for the Callback URL - Click "Submit" button - Click application name to view details - Scroll down to "Your Access Token" - Click "Generate" button - Copy "Your access token" value
  • Set the `GYAZO_ACCESS_TOKEN` environment variable with your token

Claude Desktop Integration

To use with Claude Desktop, add the server config:
On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json` On Windows: `%APPDATA%/Claude/claude_desktop_config.json`

Using NPM package (recommended)

Using Docker (optional)

Development

Install dependencies:
Build the server:
For development with auto-rebuild:

Docker Build (optional)