Gyazo

You deploy the Gyazo MCP server to expose Gyazo images as MCP resources and provide tools to search, fetch, and upload images. This server enables AI assistants to access Gyazo content via standardized MCP endpoints, returning images, metadata, and OCR when available.

How to use

Install and run the Gyazo MCP server to enable image resources and tools. You can connect to the server using an MCP client and issue requests to search for captures, fetch individual images with content and metadata, retrieve the latest image, or upload new images to Gyazo. The server presents gyazo-mcp:// style URIs for resources, and exposes tools that let you look up images by keyword or details, obtain image data, and upload images with optional metadata.

How to install

Prerequisites you need before installing:
- Node.js installed on your machine
- A Gyazo account with an API access token
- Administrative access to install global npm packages or run containers

Step by step commands

# 1) Install the MCP server globally (recommended)
npm install -g @notainc/gyazo-mcp-server

# 2) Obtain your Gyazo access token
# Follow Gyazo API token instructions and export as environment variable
export GYAZO_ACCESS_TOKEN=your-access-token-here

{
  "mcpServers": {
    "gyazo-mcp-server": {
      "command": "npx",
      "args": ["@notainc/gyazo-mcp-server"],
      "env": {
        "GYAZO_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

Optionally, you can run the MCP server via Docker with the provided token in your environment.

Claude Desktop integration (optional)

If you use Claude Desktop, place a configuration file at the following path to register the MCP server. The exact config block below is an example you can adapt with your token. On MacOS, place it at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows, place it at %APPDATA%/Claude/claude_desktop_config.json.

Docker deployment (optional)

{
  "mcpServers": {
    "gyazo-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GYAZO_ACCESS_TOKEN",
        "gyazo-mcp-server"
      ]
    }
  }
}

Notes on usage

Set the GYAZO_ACCESS_TOKEN environment variable to authorize requests to Gyazo. The MCP server will expose resources and tools for Gyazo images, including searching, fetching content and metadata, retrieving the latest image, and uploading new images with optional title, description, referer URL, and app name.

Available tools

gyazo_search

Full-text search for Gyazo captures with support for keywords, title, app, URL, and date ranges; returns matching image URIs and metadata with pagination.

gyazo_image

Fetch image content and metadata for a specific Gyazo image by ID or URL, returning both the image data and detailed metadata.

gyazo_latest_image

Fetch the most recent Gyazo image with content and metadata, including OCR data if available.

gyazo_upload

Upload an image to Gyazo with base64-encoded data and optional metadata such as title, description, referer URL, and app name; returns the image permalink and ID.