gyazo-mcp-server
About
Integrate and search for images from your Gyazo account.
Details
- Author
- nota
- GitHub stars
- 26
- Downloads
- 146
- Categories
- Cloud Service, File Management, Search, Other
Jump to
- 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.)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
gyazo-mcp-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gyazo-mcp-server": {
"gyazo-mcp-server": {
"command": "npx",
"args": [
"@notainc/gyazo-mcp-server"
],
"env": {
"GYAZO_ACCESS_TOKEN": ""
}
}
}
}
}McpServers
{
"gyazo-mcp-server": {
"command": "npx",
"args": [
"@notainc/gyazo-mcp-server"
],
"env": {
"GYAZO_ACCESS_TOKEN": ""
}
}
}gyazo-mcp-server
A Model Context Protocol server for Gyazo image integration
This is a TypeScript-based MCP server that provides access to Gyazo images. It allows AI assistants to access and interact with Gyazo images through the Model Context Protocol, providing:
- Resources representing Gyazo images with URIs and metadata
- Tools for searching, fetching, and uploading images
- Image content and metadata access via the Gyazo API
Features
Resources
- List and access Gyazo images via gyazo-mcp:// URIs
- Each image includes:
- Original image content
- Metadata (title, description, app, URL)
- OCR data (if available)
- Supports various image formats (JPEG, PNG, etc.)
Tools
- gyazo_search - Full-text search for captures uploaded by users on Gyazo
- Search by keyword, title, app, URL, or date range
- Supports pagination for browsing multiple results
- Returns matching image URIs and metadata
- gyazo_image - Fetch image content and metadata from Gyazo
- Retrieve specific images by ID or URL
- Returns both image content and detailed metadata
- gyazo_latest_image - Fetch the most recent image from Gyazo
- Returns both image content and metadata
- Includes OCR text if available
- gyazo_upload - Upload an image to Gyazo
- Upload images with base64 encoded image data
- Add optional metadata like title, description, referer URL, and app name
- Returns the uploaded image's permalink URL and ID
Installation
NPM Package
The easiest way to install the Gyazo MCP server is via npm:
npm install -g @notainc/gyazo-mcp-server
Prerequisites
- Create a Gyazo account if you don't have one: https://gyazo.com
- Get your Gyazo API access token from: https://gyazo.com/api
- Click "Register applications" button
- Click "New Application" button
- Fill in the form with your app name and description
- Name and Callback URL are required
- You can use http://localhost for the Callback URL
- Click "Submit" button
- Click application name to view details
- Scroll down to "Your Access Token"
- Click "Generate" button
- Copy "Your access token" value
- Set the GYAZO_ACCESS_TOKEN environment variable with your token
Claude Desktop Integration
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Using NPM package (recommended)
{
"mcpServers": {
"gyazo-mcp-server": {
"command": "npx",
"args": ["@notainc/gyazo-mcp-server"],
"env": {
"GYAZO_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}
Using Docker (optional)
{
"mcpServers": {
"gyazo-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GYAZO_ACCESS_TOKEN",
"gyazo-mcp-server"
],
"env": {
"GYAZO_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}
Development
Install dependencies:
npm ci
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Docker Build (optional)
npm run image:build
---
<a href="https://glama.ai/mcp/servers/bhrk879agk">
</a>
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
