Google Places MCP Server

This MCP server integrates with Google Places API to allow searching, retrieving details, and finding nearby places.

Setup

Environment Variables

The following environment variables are required:

• GOOGLE_MAPS_API_KEY: Your Google Maps API key with Places API access enabled

• TRANSPORT_TYPE: Transport method to use (stdio or sse)

• PORT: (Optional) Port number for SSE transport (default: 3000)

Create a .env file in the root directory with these variables:

GOOGLE_MAPS_API_KEY=your_api_key_here
PORT=3000

Development

1. Install dependencies:

npm install

2. Start the development server:

npm run dev

Related MCP server: Google Maps MCP Server

Transport Options

The server supports two transport methods:

1. SSE (Server-Sent Events): Uses HTTP with Server-Sent Events for real-time communication

When using SSE transport, the server exposes two endpoints:

• GET /sse: SSE endpoint for receiving server messages

• POST /messages: Endpoint for sending messages to the server

Tools

• places-text-search

  • Text search for places using Google Places API

  • Input:

    • textQuery (string, required): The text query to search for places

    • includedType (string, optional): Restricts results to places matching the specified type

    • includePureServiceAreaBusinesses (boolean, optional): Include businesses without physical location

    • languageCode (string, optional): Language code for results (e.g., "en")

    • locationBias (object, optional): Bias results toward this location

    • locationRestriction (object, optional): Restrict results to this location

    • pageSize (number, optional): Number of results per page (1-20)

    • pageToken (string, optional): Token for next page of results

    • priceLevels (array, optional): Filter by price levels

    • rankPreference (string, optional): Rank by "RELEVANCE" or "DISTANCE"

    • regionCode (string, optional): Two-character country/region code

    • strictTypeFiltering (boolean, optional): Only return exact type matches

    • evOptions (object, optional): EV charging station filters

    • minRating (number, optional): Minimum rating filter (0-5)

    • openNow (boolean, optional): Filter for places currently open

    • fields (array, optional): Specific fields to include in response

  • Returns matching places with details

• places-nearby-search (Coming Soon)

  • Find places near a specific location

  • Input:

    • location (object, required): Latitude and longitude coordinates

    • radius (number, optional): Search radius in meters

    • keyword (string, optional): Keyword to filter results

    • type (string, optional): Place type to filter results

    • rankBy (string, optional): Rank by "prominence" or "distance"

    • openNow (boolean, optional): Filter for places that are currently open

    • fields (array, optional): Specific fields to include in the response

  • Returns nearby places with details

• place-details (Coming Soon)

  • Get detailed information about a specific place

  • Input:

    • placeId (string, required): Google Place ID

    • fields (array, optional): Specific fields to include in the response

    • languageCode (string, optional): Language code for results

  • Returns comprehensive details about the place

• place-photo (Coming Soon)

  • Retrieve photos for a place

  • Input:

    • photoReference (string, required): Reference from a Place Details response

    • maxWidth (number, optional): Maximum width of the returned image

    • maxHeight (number, optional): Maximum height of the returned image

  • Returns photo data or URL