gyazo-mcp-server

@nota

About gyazo-mcp-server

Official Model Context Protocol server for Gyazo

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

Full-text search for captures uploaded by users on Gyazo

Fetch image content and metadata from Gyazo

Fetch the most recent image from Gyazo

Upload an image to Gyazo

Overview

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.

Frequently asked questions

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.

Comments

Basic information

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K