TripMCP

KhyKd/TripMCP

3.1

If you are the rightful owner of TripMCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Notion Travel MCP Server is designed to organize and populate travel information into Notion templates, enhancing travel planning and management.

Notion Travel MCP Server

An MCP (Model Context Protocol) server that helps organize and populate travel information into Notion templates matching your exact format: YYYYMMDD Destination

Features

  • Create Trip Pages: Generate complete trip pages with all template sections
  • Add Flights: Format flight details in tables with all fields (times, terminals, aircraft, booking refs)
  • Add Accommodations: Create accommodation tables with addresses, confirmations, websites, phone numbers
  • Manage Itinerary: Build day-by-day itineraries with times and activities
  • Travel To-Do Lists: Track preparation tasks with checkboxes
  • Things to Do: Maintain attraction lists for each destination
  • Parse Confirmation Emails: Automatically extract flight, hotel, and activity details from confirmation emails
  • Weather Forecasts: Get destination weather with travel-specific tips and packing recommendations

Setup

1. Create a Notion Integration

  1. Go to Notion Integrations
  2. Click "New integration"
  3. Give it a name (e.g., "Travel MCP Server")
  4. Copy the Internal Integration Token

2. Set up your Notion Travel Database

Quick Setup (Recommended)

  1. Import the template CSV:

    • Download templates/notion_travel_database.csv
    • In Notion, create a new page
    • Type /table and select "Table - Full page"
    • Click "..." → "Merge with CSV" → Upload the CSV file
    • Your database structure is ready!

  2. Or use the detailed template:

    • See templates/NOTION_DATABASE_TEMPLATE.md for complete setup
    • See templates/EXAMPLE_TRIP_HONGKONG.md for a real trip example
Manual Setup

If you prefer to create manually, add these properties:

  • Name (Title) - Format: YYYYMMDD Destination
  • Destination (Text)
  • Start Date (Date)
  • End Date (Date)
  • Travelers (Multi-select)
  • Status (Select: Planning, Booked, In Progress, Completed)
  • Budget (Number)
  • Weather URL (URL)
  • See templates/NOTION_DATABASE_TEMPLATE.md for full property list
Connect Your Database

  1. Share the database with your integration:

    • Click "..." menu → "Add connections" → Select your integration

  2. Copy the database ID from the URL:

    • Open the database as a full page
    • The URL will be: https://www.notion.so/workspace/[DATABASE_ID]?v=...

3. Configure Environment Variables

Update the .env file with your credentials:

NOTION_API_KEY=secret_abc123...  # Your integration token
NOTION_TRAVEL_DATABASE_ID=abc123def456...  # Your database ID

# Optional: Weather API keys for enhanced forecasts
OPENWEATHER_API_KEY=your_key_here  # From openweathermap.org
WEATHERAPI_KEY=your_key_here  # From weatherapi.com

4. Install Dependencies

source venv/bin/activate
pip install -r requirements.txt

5. Run the Server

python notion_travel_server.py

Usage with Claude

Once the server is running, you can tell Claude to use it to help plan your trips:

Basic Commands

  • "Create a trip to Tokyo from March 15-22"
  • "Add my flight AA123 departing LAX at 10am arriving NRT at 3pm"
  • "Add the Hilton Tokyo booking from March 15-22"
  • "Schedule dinner reservation at Sukiyabashi Jiro on March 17 at 7pm"

Email Parsing

  • "Parse this flight confirmation email: [paste email]"
  • "Extract hotel details from this booking: [paste email]"

Weather Information

  • "Get weather forecast for Tokyo in March"
  • "What should I pack for Hong Kong in August?"

New Features

Email Parsing

The server now includes intelligent email parsing that can:

  • Extract flight details (airlines, flight numbers, times, terminals, booking references)
  • Parse hotel confirmations (check-in/out dates, addresses, confirmation numbers)
  • Identify activity bookings (tours, restaurants, experiences)
  • Auto-detect email type and extract relevant information

Weather Integration

Get comprehensive weather information:

  • Current conditions and 7-day forecasts
  • Travel-specific tips (what to pack, weather warnings)
  • Multiple weather sources (OpenWeatherMap, WeatherAPI, free alternatives)
  • Automatic weather alerts for severe conditions

Next Steps

  • Integrate with calendar APIs
  • Add budget tracking and expense management
  • Support for multiple travel database templates
  • Add transportation booking (trains, rental cars)
  • Currency conversion and local cost estimates