Goyondo + Codex
Last verified
Add Goyondo to OpenAI's Codex by putting this line at the top of ~/.codex/config.toml: mcp_servers.goyondo = { command = "npx", args = ["-y", "goyondo-mcp"] }. Your assistant can then use create_trip, save_itinerary, add_activity and get_trip_alerts to plan and edit trips that persist in Goyondo.
Connect Codex to Goyondo
- Add Goyondo. Add the line to ~/.codex/config.toml, above any [table] sections, and start a new Codex session.
- First call starts sign-in. The first time Codex calls a Goyondo tool, goyondo-mcp returns a goyondo.run/connect link. Codex 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 Codex 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 use ChatGPT instead?
- Yes. In ChatGPT, add Goyondo as a connector with the URL https://goyondo.run/mcp; nothing needs installing. See /use-with-chatgpt.
- 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.