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.
