Travel Planner

v1.0.0Analyticsstable

Provides weather-aware travel planning tools that fetch 3-day forecasts and generate structured itineraries using a multi-agent orchestration system. It exposes specialized agents for weather data and trip planning to any MCP-compliant client.

travel-planner-mcp-servermcpai-integration
Share:
98
Stars
0
Downloads
0
Weekly
0/5

What is Travel Planner?

Travel Planner is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides weather-aware travel planning tools that fetch 3-day forecasts and generate structured itineraries using a multi-agent orchestration system. it exposes specialized agents for weather data and...

Provides weather-aware travel planning tools that fetch 3-day forecasts and generate structured itineraries using a multi-agent orchestration system. It exposes specialized agents for weather data and trip planning to any MCP-compliant client.

This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Provides weather-aware travel planning tools that fetch 3-da

Use Cases

Generate weather-aware travel itineraries using 3-day forecasts. Create structured trip plans with multi-agent orchestration.
GongRzhe

Maintainer

LicenseMIT License
Languagejavascript
Versionv1.0.0
UpdatedMay 8, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx travel-planner-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Travel Planner

The Travel Planner MCP Server connects AI assistants to Google Maps APIs to enable real, location-aware travel planning. It exposes four tools — searchPlaces, getPlaceDetails, calculateRoute, and getTimeZone — that let an AI look up restaurants and attractions, get detailed place information, calculate driving or transit routes between locations, and resolve time zone data for any coordinate. Travel enthusiasts and trip planners use it to generate itineraries grounded in real geodata rather than hallucinated suggestions.

Prerequisites

  • Node.js 18 or later
  • A Google Maps Platform API key with the following APIs enabled: Places API, Directions API, Geocoding API, and Time Zone API
  • An MCP-compatible client such as Claude Desktop
1

Enable Google Maps APIs

In the Google Cloud Console, create or select a project, then enable the Places API, Directions API, Geocoding API, and Time Zone API. Generate an API key under APIs & Services > Credentials.

2

Install via Smithery (quickest)

Use the Smithery CLI to install and configure the server for Claude Desktop automatically.

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

Or install manually via npm

Run the server directly with npx, passing your Google Maps API key as an environment variable.

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

Configure Claude Desktop

Add the server to your claude_desktop_config.json with the GOOGLE_MAPS_API_KEY environment variable set.

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

Restart and test

Restart Claude Desktop. Ask it to search for places or calculate a route — the assistant will invoke the appropriate tool and return real data from Google Maps.

Travel Planner Examples

Client configuration

Claude Desktop configuration for the Travel Planner MCP server with a Google Maps API key.

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

Prompts to try

Sample prompts for location search, route planning, and itinerary generation.

- "Find the top-rated Italian restaurants near the Colosseum in Rome"
- "Calculate the driving route from Paris to Amsterdam and tell me the total time"
- "What is the time zone in Tokyo, Japan right now?"
- "Get details for Google Place ID ChIJN1t_tDeuEmsRUsoyG83frY4"
- "Plan a 3-day itinerary for Kyoto, Japan including travel times between attractions"

Troubleshooting Travel Planner

API requests fail with 'REQUEST_DENIED' or billing errors

All four required Google Maps APIs (Places, Directions, Geocoding, Time Zone) must be individually enabled in Google Cloud Console, and billing must be active on the project. Free tier credits are available but a billing account must be linked.

searchPlaces returns no results for a location

Try a more specific query string. The Places API text search works best with natural descriptions like 'coffee shop near Shibuya, Tokyo'. Also ensure the Places API (New) vs. Places API (Legacy) is the correct one enabled for your key.

Server exits immediately or GOOGLE_MAPS_API_KEY is not recognized

Ensure the env key is spelled exactly 'GOOGLE_MAPS_API_KEY' (all caps, underscores). Verify the key is not restricted to specific referrers or IP addresses in Cloud Console — for MCP use, the key should allow server-side requests.

Frequently Asked Questions about Travel Planner

What is Travel Planner?

Travel Planner is a Model Context Protocol (MCP) server that provides weather-aware travel planning tools that fetch 3-day forecasts and generate structured itineraries using a multi-agent orchestration system. it exposes specialized agents for weather data and trip planning to any mcp-compliant client. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Travel Planner?

Follow the installation instructions on the Travel Planner GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Travel Planner?

Travel Planner works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Travel Planner free to use?

Yes, Travel Planner is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Analytics MCP Servers

Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "travel-planner-mcp-server": { "command": "npx", "args": ["-y", "travel-planner-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Travel Planner?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides