Travel Planner

community

Travel planning and itinerary management server integrating with Google Maps API for location search, place details, and route calculations.

Source Code

Travel Planner MCP Server (@gongrzhe/server-travelplanner-mcp)

A Travel Planner Model Context Protocol (MCP) server implementation for interacting with Google Maps and travel planning services. This server enables LLMs to perform travel-related tasks such as location search, place details lookup, and travel time calculations.

Installation & Usage

Installing via Smithery

To install Travel Planner for Claude Desktop automatically via Smithery:

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

Installing Manually

# Using npx (recommended)
npx @gongrzhe/server-travelplanner-mcp

# With environment variable for Google Maps API
GOOGLE_MAPS_API_KEY=your_api_key npx @gongrzhe/server-travelplanner-mcp

Or install globally:

# Install globally
npm install -g @gongrzhe/server-travelplanner-mcp

# Run after global installation
GOOGLE_MAPS_API_KEY=your_api_key @gongrzhe/server-travelplanner-mcp

Components

Tools

searchPlaces
- Search for places using Google Places API
- Input:
  - ```
  query
```
  (string): Search query for places
- ```
location
```
    (optional): Latitude and longitude to bias results
  - ```
  radius
```
  (optional): Search radius in meters
getPlaceDetails
- Get detailed information about a specific place
- Input:
  - ```
  placeId
```
  (string): Google Place ID to retrieve details for
calculateRoute
- Calculate route between two locations
- Input:
  - ```
  origin
```
  (string): Starting location
- ```
destination
```
    (string): Ending location
  - ```
  mode
```
  (optional): Travel mode (driving, walking, bicycling, transit)
getTimeZone
- Get timezone information for a location
- Input:
  - ```
  location
```
  : Latitude and longitude coordinates
- ```
timestamp
```
    (optional): Timestamp for time zone calculation

Configuration

Usage with Claude Desktop

To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your

claude_desktop_config.json

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

Alternatively, you can use the node command directly if you have the package installed:

{
  "mcpServers": {
    "travel-planner": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "your_google_maps_api_key"
      }
    }
  }
}

Development

Building from Source

Clone the repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Environment Variables

```
GOOGLE_MAPS_API_KEY
```
(required): Your Google Maps API key with the following APIs enabled:
- Places API
- Directions API
- Geocoding API
- Time Zone API

License

This MCP server is licensed under the MIT License. For more details, please see the LICENSE file in the project repository.

Related Servers

Brave Search

reference

Web and local search using Brave's Search API

View Details

Git

reference

Tools to read, search, and manipulate Git repositories

View Details

Google Drive

reference

File access and search capabilities for Google Drive

View Details

Aiven

official

Navigate your [Aiven projects](https://go.aiven.io/mcp-server) and interact with the PostgreSQL®, Apache Kafka®, ClickHouse® and OpenSearch® services

View Details

Apify

official

[Actors MCP Server](https://apify.com/apify/actors-mcp-server): Use 3,000+ pre-built cloud tools to extract data from websites, e-commerce, social media, search engines, maps, and more

View Details