Gyazo MCP Server
Gyazo image retrieval and search tools for AI assistant workflows.
Data last scanned today · Reviewed today
Overview
This TypeScript-based MCP server enables AI models to interact directly with your Gyazo image library. It provides a structured way to fetch images using their internal IDs, search through captures by keyword or metadata, and retrieve metadata such as OCR data and application names via the Gyazo API. Beyond basic retrieval, the server supports uploading new images to Gyazo directly from an AI session by accepting base64-encoded image data. It organizes these interactions through defined resources and tools, allowing for streamlined browsing of recent captures or targeted searches across your image history.
Our verdict
The Gyazo MCP Server holds a high risk security score of 43/100, largely because the authentication method and read-only mode support remain unreviewed. As a community-maintained project rather than an official integration, users should exercise caution when inputting API tokens. It is recommended for developers who require direct image access in local environments but should be avoided in sensitive or shared infrastructures until the security configuration undergoes professional auditing.
- Supports full-text search across user image captures.
- Small footprint with only three direct dependencies.
- Provides access to OCR data associated with images.
- Maintains recent commit activity to the repository.
- Authentication method has not been independently reviewed.
- Not an official integration provided by the vendor.
- Read-only capabilities remain unverified for safety.
Setup
{
"mcpServers": {
"gyazo-mcp-server": {
"args": [
"-y",
"@notainc/gyazo-mcp-server"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| gyazo_search | Full-text search for captures uploaded by users on Gyazo | low |
| gyazo_image | Fetch image content and metadata from Gyazo | low |
| gyazo_latest_image | Fetch the most recent image from Gyazo | low |
| gyazo_upload | Upload an image to Gyazo | medium |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What prerequisites are needed to use this server?
You must have a Gyazo account and a generated Gyazo API access token, which can be obtained via the Gyazo API dashboard.
›How do I configure the API credentials?
You must set the GYAZO_ACCESS_TOKEN environment variable in your MCP configuration file to authenticate with the Gyazo API.
›Does this server support uploading images?
Yes, the gyazo_upload tool allows you to upload images using base64 encoded data along with optional metadata like title, description, referer URL, and app name.
›What information can the server retrieve from my Gyazo account?
It can retrieve image content, metadata such as title and description, and OCR text associated with your images.
›Can I search for specific images using this server?
Yes, you can use the gyazo_search tool to perform full-text searches across your captures based on keywords, title, app, URL, or date range.
Changelog
Badge
Maintain this server? Add the live badge to your README.