colakang/google-places-mcp

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

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