Tripadvisor MCP Server

Travel & TransportationPython

Access Tripadvisor location data, reviews, and photos for travel planning

Available Tools

search_locations

Search for locations by query text, category, and other filters

querycategoryfilters

search_nearby_locations

Find locations near specific coordinates

latitudelongituderadiuscategory

get_location_details

Get detailed information about a location

location_id

get_location_reviews

Retrieve reviews for a location

location_idlimit

get_location_photos

Get photos for a location

location_idlimit

The Tripadvisor MCP provides AI assistants with access to Tripadvisor's Content API through standardized Model Context Protocol interfaces. This integration enables searching for travel destinations, hotels, restaurants, and attractions, along with retrieving detailed information, reviews, and photos. With this MCP, AI assistants can help users plan trips, find highly-rated accommodations, discover popular attractions, and make informed travel decisions based on authentic Tripadvisor content. The server supports location-based searches, allowing users to find points of interest near specific coordinates.

Getting Started

To use the Tripadvisor MCP, you'll need to obtain an API key from the Tripadvisor Developer Portal.

Installation

There are two main ways to install and run the Tripadvisor MCP:

Method 1: Direct Installation

Clone the repository:

git clone https://github.com/pab1it0/tripadvisor-mcp.git
cd tripadvisor-mcp

Create a .env file in the project directory with your API key:

TRIPADVISOR_API_KEY=your_api_key_here

Install dependencies using uv:

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows
uv pip install -e .

Configure your AI assistant client to use the MCP server.

Method 2: Docker Installation

Build the Docker image:

docker build -t tripadvisor-mcp-server .

Run the container with your API key:

docker run -it --rm -e TRIPADVISOR_API_KEY=your_api_key_here tripadvisor-mcp-server

Configuration

To configure your AI assistant client (like Claude Desktop), add the following to your client configuration file:

For direct installation:

{
  "mcpServers": {
    "tripadvisor": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/tripadvisor-mcp",
        "run",
        "src/tripadvisor_mcp/main.py"
      ],
      "env": {
        "TRIPADVISOR_API_KEY": "your_api_key_here"
      }
    }
  }
}

For Docker installation:

{
  "mcpServers": {
    "tripadvisor": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "TRIPADVISOR_API_KEY",
        "tripadvisor-mcp-server"
      ],
      "env": {
        "TRIPADVISOR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Troubleshooting

If you see Error: spawn uv ENOENT in Claude Desktop, you may need to specify the full path to the uv executable or set the environment variable NO_UV=1 in the configuration.
Ensure your Tripadvisor API key is valid and has the necessary permissions.
Check that the Docker image is built correctly if using the Docker installation method.

Usage Examples

Once configured, you can use the Tripadvisor MCP to:

Search for hotels, restaurants, and attractions
Get detailed information about specific locations
Read reviews for places of interest
View photos of destinations
Find nearby points of interest based on coordinates

The MCP provides a standardized interface for AI assistants to access this information and help users with travel planning.