MCP tools reference

Wanderlog MCP tools

14 tools for Wanderlog on the Cotlet MCP server. Your agent picks them from tools/list.

MCP server
https://cotlet.dev/mcp/v1
Connects with
Your own Wanderlog account (trips you own or can edit)
Integration page
Wanderlog
Wanderlog Endpoints
Endpoint Access Description
wanderlog_list_trips read Your trips and trips shared with you, with destination, dates and tripmates.
wanderlog_get_trip read Full itinerary: days, places with times and notes, hotels, reservations, lists and checklists.
wanderlog_search_places read Find attractions, restaurants and hotels near the trip destination, with rating and address.
wanderlog_list_expenses read Trip expenses with amount, currency, category and date, plus totals by category.
wanderlog_get_trip_forwarding_email read The address to forward flight, hotel and car confirmations to for this trip.
wanderlog_create_trip write New trip plan for a destination and date range. Private until you invite someone.
wanderlog_add_place write Add a place to a day of the itinerary or to a list such as "Places to visit".
wanderlog_remove_place write Remove a place from a day or list.
wanderlog_add_hotel write Add lodging with check-in and check-out dates and an optional confirmation number.
wanderlog_add_note write Free-text note on a day or the trip: transit tips, opening hours, booking details.
wanderlog_add_checklist write Checklist for packing, to-dos or shopping, for the whole trip or one day.
wanderlog_add_expense write Log an expense in the currency you paid in, optionally split between tripmates.
wanderlog_optimize_day_route write Reorder the places of one day for a shorter route, as the app's route optimization does.
wanderlog_invite_tripmate write Invite someone by email to collaborate on the trip.

List trips

read

MCP tool wanderlog_list_trips

Returns trips you own and trips shared with you, soonest first. Use trip_id from each item in the other tools. Tripmates are listed by name and ID.

Parameters

Parameters: list_trips
NameTypeDescription
when enum upcoming, past or all. Default: upcoming.
limit integer 1 to 50. Default: 20.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_list_trips",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trips": [
      {
        "trip_id": "tr_8kQ2mZ",
        "title": "Portugal 2027",
        "destination": "Portugal",
        "start_date": "2027-05-12",
        "end_date": "2027-05-19",
        "tripmates": [
          {
            "tripmate_id": "tm_41a",
            "name": "Maya Novak"
          }
        ],
        "url": "https://wanderlog.com/plan/tr_8kQ2mZ"
      }
    ]
  },
  "isError": false
}

Get trip

read

MCP tool wanderlog_get_trip

Returns the itinerary day by day, with places in the order they appear. Each place has a block_id for remove_place. Pass day to return one day only.

Parameters

Parameters: get_trip
NameTypeDescription
trip_id required string Trip ID from list_trips.
day date Return only this day.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_get_trip",
    "arguments": {
      "trip_id": "trip_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "tr_8kQ2mZ",
    "title": "Portugal 2027",
    "days": [
      {
        "date": "2027-05-12",
        "places": [
          {
            "block_id": "blk_1a20",
            "name": "Belem Tower",
            "start_time": "10:00",
            "note": "Buy tickets online"
          },
          {
            "block_id": "blk_1a21",
            "name": "Pasteis de Belem",
            "start_time": "12:30",
            "note": null
          }
        ]
      }
    ],
    "hotels": [],
    "checklists": []
  },
  "isError": false
}

Search places

read

MCP tool wanderlog_search_places

Searches near the trip destination and returns up to the limit, best match first, with a place_id for add_place and add_hotel. Nothing is added to the trip.

Parameters

Parameters: search_places
NameTypeDescription
trip_id required string Trip ID from list_trips.
query required string What to find, e.g. "seafood restaurant" or "Belem Tower".
limit integer 1 to 20. Default: 10.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_search_places",
    "arguments": {
      "trip_id": "trip_8c41d2",
      "query": "seafood restaurant"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "places": [
      {
        "place_id": "pl_91c0",
        "name": "Time Out Market Lisboa",
        "category": "restaurant",
        "rating": 4.4,
        "address": "Av. 24 de Julho 49, Lisboa"
      }
    ]
  },
  "isError": false
}

List expenses

read

MCP tool wanderlog_list_expenses

Returns the expenses logged on the trip, newest first, with the currency each was paid in. Totals by category are in the trip's home currency, as the app shows them.

Parameters

Parameters: list_expenses
NameTypeDescription
trip_id required string Trip ID from list_trips.
category string Only this category, e.g. food or lodging.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_list_expenses",
    "arguments": {
      "trip_id": "trip_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "expenses": [
      {
        "expense_id": "ex_72d1",
        "amount": "64.50",
        "currency": "EUR",
        "category": "food",
        "description": "Dinner at Time Out Market",
        "date": "2027-05-13"
      }
    ],
    "totals_by_category": [
      {
        "category": "food",
        "amount": "64.50",
        "currency": "EUR"
      }
    ]
  },
  "isError": false
}

Get booking import address

read

MCP tool wanderlog_get_trip_forwarding_email

Returns the address Wanderlog shows for forwarding confirmation emails to this trip. Forward a confirmation from your mail client and Wanderlog fills in dates and times. Cotlet does not read your mailbox.

Parameters

Parameters: get_trip_forwarding_email
NameTypeDescription
trip_id required string Trip ID from list_trips.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_get_trip_forwarding_email",
    "arguments": {
      "trip_id": "trip_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "tr_8kQ2mZ",
    "forwarding_email": "<your trip's forwarding address>"
  },
  "isError": false
}

Create trip

write

MCP tool wanderlog_create_trip

Creates a trip with one day per date between start and end. The trip is visible only to you until invite_tripmate. It reaches no one and you can delete it in the app, so it runs without asking.

Parameters

Parameters: create_trip
NameTypeDescription
destination required string City, region or country.
start_date required date First day of the trip.
end_date required date Last day of the trip.
title string Trip name. Default: "Trip to {destination}".

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_create_trip",
    "arguments": {
      "destination": "Lisbon, Portugal",
      "start_date": "2027-05-12",
      "end_date": "2027-05-15",
      "title": "Lisbon long weekend"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "tr_5nT7pL",
    "title": "Lisbon long weekend",
    "destination": "Lisbon, Portugal",
    "start_date": "2027-05-12",
    "end_date": "2027-05-15",
    "days": 4,
    "url": "https://wanderlog.com/plan/tr_5nT7pL"
  },
  "isError": false
}

Add place

write

MCP tool wanderlog_add_place

Adds the place at the end of the day, or of the list when no day is given. On a shared trip, tripmates see it as the app syncs in real time. It runs without asking, because it is undone with remove_place.

Parameters

Parameters: add_place
NameTypeDescription
trip_id required string Trip ID from list_trips.
place required string Place ID from search_places, or a name to look up.
day date Day of the trip. Omit to use the trip-level list or notes instead.
list string List heading when no day is given. Default: Places to visit.
start_time string HH:MM, local time.
note string Note shown under the place.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_add_place",
    "arguments": {
      "trip_id": "trip_8c41d2",
      "place": "place"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "block_id": "blk_2c07",
    "trip_id": "tr_8kQ2mZ",
    "name": "Castelo de S. Jorge",
    "day": "2027-05-13",
    "start_time": "10:00"
  },
  "isError": false
}

Remove place

write

MCP tool wanderlog_remove_place

Removes one entry from the itinerary. Use block_id from get_trip. It runs without asking, because add_place puts it back.

Parameters

Parameters: remove_place
NameTypeDescription
trip_id required string Trip ID from list_trips.
block_id required string Place entry ID from get_trip.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_remove_place",
    "arguments": {
      "trip_id": "trip_8c41d2",
      "block_id": "block_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "block_id": "blk_2c07",
    "status": "removed"
  },
  "isError": false
}

Add hotel

write

MCP tool wanderlog_add_hotel

Adds a lodging entry with the dates you pass and returns the number of nights. It runs without asking, because it reaches no one outside the trip and is removed with remove_place.

Parameters

Parameters: add_hotel
NameTypeDescription
trip_id required string Trip ID from list_trips.
place required string Hotel place ID or name.
check_in required date Check-in date.
check_out required date Check-out date.
confirmation string Booking confirmation number.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_add_hotel",
    "arguments": {
      "trip_id": "tr_8kQ2mZ",
      "place": "Hotel Infante Sagres, Porto",
      "check_in": "2027-05-16",
      "check_out": "2027-05-19",
      "confirmation": "HB-4471902"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "block_id": "blk_31f9a0",
    "trip_id": "tr_8kQ2mZ",
    "type": "hotel",
    "name": "Hotel Infante Sagres",
    "check_in": "2027-05-16",
    "check_out": "2027-05-19",
    "nights": 3,
    "url": "https://wanderlog.com/plan/tr_8kQ2mZ"
  },
  "isError": false
}

Add note

write

MCP tool wanderlog_add_note

Adds a note to the day you name, or to the trip when no day is given. It runs without asking, because it reaches no one outside the trip and is removed with remove_place.

Parameters

Parameters: add_note
NameTypeDescription
trip_id required string Trip ID from list_trips.
text required string Note text.
day date Day of the trip. Omit to use the trip-level list or notes instead.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_add_note",
    "arguments": {
      "trip_id": "trip_8c41d2",
      "text": "text"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "block_id": "blk_4b12",
    "trip_id": "tr_8kQ2mZ",
    "status": "added"
  },
  "isError": false
}

Add checklist

write

MCP tool wanderlog_add_checklist

Creates a checklist with the items you pass, all unchecked. It runs without asking, because it reaches no one outside the trip and you can delete it in the app.

Parameters

Parameters: add_checklist
NameTypeDescription
trip_id required string Trip ID from list_trips.
title required string Checklist heading, e.g. Packing.
items required string[] Checklist items, unchecked.
day date Day of the trip. Omit to use the trip-level list or notes instead.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_add_checklist",
    "arguments": {
      "trip_id": "trip_8c41d2",
      "title": "title",
      "items": [
        "items"
      ]
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "checklist_id": "cl_66e2",
    "trip_id": "tr_8kQ2mZ",
    "title": "Packing",
    "items": 4,
    "checked": 0
  },
  "isError": false
}

Add expense

write Confirm

MCP tool wanderlog_add_expense

Logs the expense with its category and date (today by default). With split_with, the app shows who owes whom, so this reaches tripmates. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: add_expense
NameTypeDescription
trip_id required string Trip ID from list_trips.
amount required string Decimal amount, e.g. "64.50".
currency required string ISO 4217 code, e.g. EUR.
category required string Expense category, e.g. food or lodging.
description string What it was.
date date Default: today.
split_with string[] Tripmate IDs from list_trips. Default: not split.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_add_expense",
    "arguments": {
      "trip_id": "tr_8kQ2mZ",
      "amount": "86.40",
      "currency": "EUR",
      "category": "food",
      "description": "Dinner at Cervejaria Ramiro",
      "date": "2027-05-13",
      "split_with": [
        "tm_41a",
        "tm_52c"
      ]
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "expense_id": "ex_72d1",
    "trip_id": "tr_8kQ2mZ",
    "amount": "64.50",
    "currency": "EUR",
    "category": "food",
    "date": "2027-05-13",
    "split_with": []
  },
  "isError": false
}

Optimize day route

write

MCP tool wanderlog_optimize_day_route

Reorders the places of one day and returns the new order. It runs without asking, because the old order is in the response and you can restore it with remove_place and add_place.

Parameters

Parameters: optimize_day_route
NameTypeDescription
trip_id required string Trip ID from list_trips.
day required date Day to reorder.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_optimize_day_route",
    "arguments": {
      "trip_id": "trip_8c41d2",
      "day": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "tr_8kQ2mZ",
    "day": "2027-05-14",
    "order": [
      "Castelo de S. Jorge",
      "Alfama walk",
      "Time Out Market Lisboa"
    ]
  },
  "isError": false
}

Invite tripmate

write Confirm

MCP tool wanderlog_invite_tripmate

Sends the invitation for the trip to the email you pass. The person sees the itinerary once they accept. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: invite_tripmate
NameTypeDescription
trip_id required string Trip ID from list_trips.
email required string Their email.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wanderlog_invite_tripmate",
    "arguments": {
      "trip_id": "trip_8c41d2",
      "email": "jane@example.com"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "trip_id": "tr_8kQ2mZ",
    "email": "friend@example.com",
    "status": "invited"
  },
  "isError": false
}