Goyondo + Gemini CLI
Last verified
Add Goyondo to Gemini CLI by putting this entry under mcpServers in ~/.gemini/settings.json: "goyondo": { "command": "npx", "args": ["-y", "goyondo-mcp"] }. Your assistant can then use create_trip, save_itinerary, add_activity and get_trip to plan and edit trips that persist in Goyondo.
Connect Gemini CLI to Goyondo
- Add Goyondo. Add the entry under mcpServers in ~/.gemini/settings.json (or .gemini/settings.json in one project), restart Gemini CLI and run /mcp to check Goyondo is connected.
- First call starts sign-in. The first time Gemini CLI calls a Goyondo tool, goyondo-mcp returns a goyondo.run/connect link. Gemini CLI shows it to you.
- Approve one link. Open the link, sign in to Goyondo, check the permissions and grant access. goyondo-mcp saves the key to ~/.config/goyondo/credentials.json, readable only by you. Keys last 90 days by default.
- Plan and keep editing. Ask Gemini CLI to plan a trip and save it to Goyondo. Open goyondo.run to see it, edit it yourself or invite your group.
Example prompts
Plan a 3-day trip to Lisbon from 12 to 14 May for two people who love food, and save it to Goyondo.List my Goyondo trips and tell me which days of the Lisbon trip still have free afternoons.In my Goyondo Lisbon trip, move the Belém visit to the second morning, then check the trip for alerts.Tools your assistant can use
| Tool | What it does |
|---|---|
list_trips | List trips for the authenticated user, newest first. Returns trip id, destination, dates and status. Pages with limit and offset: when has_more is true, call again with offset set to next_offset. |
get_trip | Get a single trip by id including full itinerary (days and activities). trip.origin is where the trip starts and trip.journey the estimated flight hours and time difference (estimates; say "about"). |
create_trip | Create a new trip and optionally generate an AI itinerary, which can take up to a few minutes. Returns the created trip and itinerary. Pass fixed_plans for tickets, reservations and must-sees. To write the itinerary yourself, pass skip_ai_generation: true and then call save_itinerary with all the days in one call. |
update_trip | Update trip metadata such as dates, title, traveler count, budget, or status. When start_date or end_date changes, the response includes itinerary_dates showing the first and last day dates after the shift — verify these match your intended dates before proceeding. |
add_activity | Add an activity to a trip. To assign to a specific day use itinerary_id (UUID from get_trip itinerary days — most reliable), date (YYYY-MM-DD), or day_number (1-based). If none are provided the activity lands on Day 1. The result includes warnings (duplicates, time overlaps) for the new activity; fix them or tell the user. To add several activities, use save_itinerary. |
update_activity | Update an existing activity. All fields except trip_id and activity_id are optional. The result includes warnings (duplicates, time overlaps) involving the activity. Changing anything other than status marks the activity as the user's, so regenerate_itinerary keeps it. |
delete_activity | Delete an activity from a trip. Regeneration will not suggest it again. If the activity belongs to a fixed plan, that day is removed from the plan, or the whole plan if it was the last day. |
regenerate_itinerary | Regenerate the AI itinerary for an existing trip. Replaces AI suggestions only: fixed plans and activities the user or an agent added or edited are kept, and removed activities are not suggested again. |
Frequently asked questions
- What do I need installed?
- Node.js 18 or later, so that npx can run goyondo-mcp. Nothing else: the package fetches Goyondo's live tool list when it starts, so new tools appear without an update.
- Can I add it from the command line instead?
- Yes. gemini mcp add writes the same entry; pass -s user to make Goyondo available in every project rather than only the current one.
- How do I remove access?
- The key goyondo-mcp saves appears under API keys in your Goyondo profile. Revoke it there at any time, and delete ~/.config/goyondo/credentials.json on your machine. Every change an assistant makes shows in the trip's edit log.
- Do I need to pay?
- No. Self-authored trips have no trip-count cap. The free plan includes 3 active Goyondo AI-planned trips, creating an API key raises that allowance to 10, and Pro removes the AI trip-count cap.