# Mcp Google Custom Search Server

> An mcp server for searching against google custom search api

- **Type:** MCP server
- **Install:** `agentstack add mcp-limklister-mcp-google-custom-search-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [limklister](https://agentstack.voostack.com/s/limklister)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [limklister](https://github.com/limklister)
- **Source:** https://github.com/limklister/mcp-google-custom-search-server

## Install

```sh
agentstack add mcp-limklister-mcp-google-custom-search-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Google Custom Search Server

A Model Context Protocol (MCP) server that provides web search capabilities through Google's Custom Search API. This server enables Language Learning Models (LLMs) to perform web searches using a standardized interface.

## 🌟 Features

- Seamless integration with Google Custom Search API
- Model Context Protocol (MCP) compliant server implementation
- Type-safe implementation using TypeScript
- Environment variable configuration
- Input validation using Zod
- Configurable search results (up to 10 per query)
- Formatted search results including titles, URLs, and descriptions
- Error handling and validation
- Compatible with Claude Desktop and other MCP clients

## 📋 Prerequisites

Before you begin, ensure you have:

1. A Google Cloud Project with Custom Search API enabled

   - Visit [Google Cloud Console](https://console.cloud.google.com)
   - Enable the Custom Search API
   - Create API credentials

2. A Custom Search Engine ID

   - Visit [Programmable Search Engine](https://programmablesearchengine.google.com/)
   - Create a new search engine
   - Get your Search Engine ID

3. Local development requirements:
   - Node.js (v18 or higher)
   - npm (comes with Node.js)

## 🚀 Quick Start

1. Clone the repository:

   ```bash
   git clone https://github.com/limklister/mcp-google-custom-search-server.git
   cd mcp-google-custom-search-server
   ```

2. Install dependencies:

   ```bash
   npm install
   ```

3. Create a .env file:

   ```bash
   GOOGLE_API_KEY=your-api-key
   GOOGLE_SEARCH_ENGINE_ID=your-search-engine-id
   ```

4. Build the server:

   ```bash
   npm run build
   ```

5. Start the server:
   ```bash
   npm start
   ```

## 🔧 Configuration

### Environment Variables

| Variable                | Description                       | Required |
| ----------------------- | --------------------------------- | -------- |
| GOOGLE_API_KEY          | Your Google Custom Search API key | Yes      |
| GOOGLE_SEARCH_ENGINE_ID | Your Custom Search Engine ID      | Yes      |

### Claude Desktop Integration

Add this configuration to your Claude Desktop config file (typically located at `~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "google-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-google-custom-search-server/build/index.js"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-api-key",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id"
      }
    }
  }
}
```

## 📖 API Reference

### Available Tools

#### search

Performs a web search using Google Custom Search API.

**Parameters:**

- `query` (string, required): The search query to execute
- `numResults` (number, optional): Number of results to return
  - Default: 5
  - Maximum: 10

**Example Response:**

```
Result 1:
Title: Example Search Result
URL: https://example.com
Description: This is an example search result description
---

Result 2:
...
```

## 🛠️ Development

### Project Structure

```
mcp-google-custom-search-server/
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript output
├── .env                  # Environment variables
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # Project documentation
```

### Available Scripts

- `npm run build`: Compile TypeScript to JavaScript
- `npm start`: Start the MCP server
- `npm run dev`: Watch mode for development

### Testing

1. Using MCP Inspector:

   ```bash
   npx @modelcontextprotocol/inspector node build/index.js
   ```

2. Manual testing with example queries:
   ```bash
   # After starting the server
   {"jsonrpc":"2.0","id":1,"method":"callTool","params":{"name":"search","arguments":{"query":"example search"}}}
   ```

  

[](https://mseep.ai/app/limklister-mcp-google-custom-search-server)

## 📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

## 🙏 Acknowledgments

- Built with [Model Context Protocol (MCP)](https://github.com/anthropics/model-context-protocol)
- Uses Google's Custom Search API
- Inspired by the need for better search capabilities in LLM applications

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [limklister](https://github.com/limklister)
- **Source:** [limklister/mcp-google-custom-search-server](https://github.com/limklister/mcp-google-custom-search-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-limklister-mcp-google-custom-search-server
- Seller: https://agentstack.voostack.com/s/limklister
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.