gyazo-mcp-server

Name: gyazo-mcp-server
Author: yuiseki

@yuiseki

Repository Homepage

About gyazo-mcp-server

Official Model Context Protocol server for Gyazo

Basic information

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 enables AI assistants to access, search, upload, and fetch metadata for images stored in Gyazo. It provides resources via gyazo-mcp:// URIs and tools for full-text search, image retrieval, and upload.

How to use gyazo-mcp-server?

Install the npm package globally: npm install -g @notainc/gyazo-mcp-server. Obtain a Gyazo API access token from your Gyazo account and set the GYAZO_ACCESS_TOKEN environment variable. For Claude Desktop, add a server configuration under mcpServers with command: "npx", args: ["@notainc/gyazo-mcp-server"], and the token in env. An optional Docker configuration is also provided.

Key features of gyazo-mcp-server

List and access Gyazo images via custom URI scheme
Each image includes original content, metadata, and OCR data
Full‑text search across captions, titles, apps, URLs, or date ranges
Fetch specific images by ID or URL
Retrieve the most recent image with OCR text if available
Upload images with base64 data and optional metadata

Use cases of gyazo-mcp-server

AI assistants searching a user’s Gyazo captures by keyword
Retrieving the latest screenshot or image along with its OCR text
Uploading new images programmatically with custom titles and descriptions
Browsing paginated search results to find relevant screenshots
Integrating Gyazo image metadata into chat or workflow tools

FAQ from gyazo-mcp-server

What runtime does gyazo-mcp-server require?

It is written in TypeScript and runs on Node.js. The recommended installation uses npm.

How do I get a Gyazo API access token?

Create a Gyazo account, register an application at https://gyazo.com/api, generate an access token for that application, and set it as the GYAZO_ACCESS_TOKEN environment variable.

Can I upload images with this server?

Yes, the gyazo_upload tool accepts base64‑encoded image data and optional metadata (title, description, referer URL, app name). It returns the permalink URL and image ID.

Where are the images stored?

All images are stored on Gyazo’s cloud service. The server acts as a bridge to access and manage those images via the Gyazo API.

What transport does the server use?

The server uses standard MCP stdio transport (configured via command and args in Claude Desktop). No additional network configuration is required beyond setting the API token.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K