🖼️ Google Images Search MCP

<img src="https://i.postimg.cc/sgpqkgtR/PM.webp" alt="logo" width="50%">

Search. See. Save. – The only MCP that shows Google Images results directly in your chat as actual images, not just links!

Unlike other tools that return text descriptions or links, this MCP displays search results as actual images in your conversation. Works with Cline and Windsurf.

Perfect for getting visual inspiration, finding assets for projects, or quickly browsing images without leaving your IDE.

Demo

Usage & Requirements

Requirements

• Node.js v20+
• Google Cloud Platform account (free tier sufficient)
• Compatible IDE: Cline or Windsurf

Setup Guide

Follow these steps to set up this MCP:

Step 1: create Google Custom search engine

1. Go to Google Programmable Search Engine
2. Click "Add" to create a new search engine
3. In "Sites to search", enter * (asterisk) to search the entire web
4. Give your search engine a name (e.g., "My Image Search")
5. In the search engine settings, enable "Image search" option
6. Click "Create"
7. Copy the Search engine ID - you'll need this for configuration

Step 2: Get Google API Key

1. Go to Google Cloud Console API Credentials
2. If you don't have a project, create one
3. Click "+ CREATE CREDENTIALS" → "API key"
4. Copy the generated API key
5. (Optional) Restrict the API key to "Custom Search API" for security

Step 3: Configure MCP in Your IDE

Add the following configuration to your MCP settings:

{
  "mcpServers": {
    "googleImagesSearch": {
      "command": "npx",
      "args": ["-y", "@srigi/mcp-google-images-search"],
      "env": {
        "API_KEY": "your-google-api-key-here",
        "SEARCH_ENGINE_ID": "your-search-engine-id-here"
      },
      "autoApprove": ["search_image", "persist_image"]
    }
  }
}

Replace your-google-api-key-here and your-search-engine-id-here with the values from steps 1 and 2.

Usage Example

Here's how to use the MCP once configured:

1. Search for images: Ask your AI assistant to search for images

   Find 5 images of F-22
   

2. Get more results: Request additional search results

   Find 5 more images
   

3. Save an image: Ask to save a specific result to your project

   Save the 3rd image to the "assets" folder
   

The MCP will display the search results as actual images in your chat history, and you can easily save any of them to your local project directory.

🚀 Development

Want to contribute? Great! Quality contributions are welcomed.

Requirements: Node.js v20+, direnv, PNPM v10

Quick start:

1. Copy .envrc (example) to .envrc and add your Google API credentials
2. Run pnpm install && pnpm dev
3. Update your MCP configuration for development:

{
  "mcpServers": {
    "googleImagesSearch": {
      "command": "node",
      "args": ["/absolute/path/to/project/src/index.js", "--debug", "--pretty-print"],
      "env": {
        "API_KEY": "your-google-api-key-here",
        "SEARCH_ENGINE_ID": "your-search-engine-id-here"
      },
      "autoApprove": ["search_image", "persist_image"]
    }
  }
}

Debug options:

• --debug - Enable detailed logging for troubleshooting
• --pretty-print - Format JSON responses for better readability

Changes auto-recompile, but restart your MCP server to apply them. Check logs/info.log for debugging.

Use pnpm dev:inspector for interactive testing in the browser.

🛠️ Available Tools

🔍 search_image - Find images using Google's vast database

• query (required) - What you're looking for
• count (1-10, default: 2) - How many results
• safe ('off'/'medium'/'high') - Filter level
• startIndex - For pagination

💾 persist_image - Download and save images to your project

• url (required) - Image URL to download
• targetPath (required) - Where to save it (folder or full path)

Security features: Path validation, MIME type checking, 10MB size limit, supports all major image formats (JPEG, PNG, GIF, WebP, SVG, etc.)

---

🔗 Links: GitHub • NPM • Issues