Name: Travel Planner MCP
Author: GongRzhe

An open-source MCP server that lets LLMs perform travel planning tasks through the Google Maps platform. It exposes four tools: searchPlaces (Google Places queries with optional location bias and radius), getPlaceDetails (full details from a place ID), calculateRoute (driving, walking, bicycling or transit between two points) and getTimeZone.

Works with Claude Desktop, Cursor and any MCP-compatible client. Requires a Google Maps API key with the Places, Directions, Geocoding and Time Zone APIs enabled. MIT licensed, installable via npx or Smithery.

Documentation

Installation and usage

Install automatically for Claude Desktop via Smithery:

npx -y @smithery/cli install @GongRzhe/TRAVEL-PLANNER-MCP-Server --client claude

Or run manually with npx:

GOOGLE_MAPS_API_KEY=your_api_key npx @gongrzhe/server-travelplanner-mcp

Global installation is also supported through npm install -g @gongrzhe/server-travelplanner-mcp.

Components

The server exposes four tools to the LLM:

searchPlaces: search places through the Google Places API, with query plus optional location bias and radius in meters
getPlaceDetails: full details for a place from its placeId
calculateRoute: route between origin and destination, with optional mode (driving, walking, bicycling, transit)
getTimeZone: timezone for coordinates, with an optional timestamp

Configuration

For Claude Desktop, declare the server in the mcpServers section of claude_desktop_config.json:

{
  "mcpServers": {
    "travel-planner": {
      "command": "npx",
      "args": ["@gongrzhe/server-travelplanner-mcp"],
      "env": { "GOOGLE_MAPS_API_KEY": "your_google_maps_api_key" }
    }
  }
}

The GOOGLE_MAPS_API_KEY is required and must have the Places, Directions, Geocoding and Time Zone APIs enabled.

Development

Build from source: clone the repository, then run npm install followed by npm run build.

License

MIT. See the LICENSE file in the repository.

Travel Planner MCP