Polarsteps automation
Export a single Polarsteps trip as GPX or Markdown
You finished a trip and want its route in Komoot, Google Earth or a GPS watch, or its stories in a notes app. Polarsteps shows the route on its own map, but it has no button that saves one trip as a file.
Cotlet does it in your own Polarsteps account with list_trips and export_trip, called by your AI agent, an n8n workflow or a script.
Hosted · nothing to install or maintain
Official options
Can Polarsteps do this on its own?
Polarsteps has no API and no per-trip export (checked 12 Oct 2026). The help center says a trip cannot be exported to PDF. The two official ways out are "Download my data", an archive of the whole account sent by email, and a printed Travel Book. Neither gives you a GPX file.
By hand
How you do it in Polarsteps today
- Log in at polarsteps.com on a laptop or desktop, click your name in the top right corner and choose Account settings.
- Scroll to "Download my data" in the privacy section, click "Download a copy of your data", then "Start My Archive", and enter your Polarsteps password.
- Wait for the Polarsteps email with the download link and unzip the archive of every trip on the account.
- Open user_data > trip, find the folder of the one trip you need, and read its locations.json in a JSON reader.
- Convert those coordinates to GPX yourself, with a script or an online converter. Every new request builds the archive of the whole account again, even when you need one trip.
With an agent
How to export a single Polarsteps trip as GPX or Markdown
Prompt
Export my Patagonia trip as a GPX file for Komoot and a Markdown journal, without the photos. - 01
Find the right trip
The agent calls list_trips with status past and matches your words against trip names and dates. When "Japan" and "Japan 2024" both fit, it shows both and asks which one before exporting anything.
- 02
Choose the format from your goal
A route for Komoot, Garmin or Google Earth means gpx. A journal for Obsidian or a notes app means markdown. A backup that keeps everything means json. Two goals mean two export_trip calls, one per format.
- 03
Leave out photos unless asked
include_media stays false by default, because a long trip with hundreds of photos makes a large zip. The agent turns it on only when you say you want the pictures too.
- 04
Save the file before the link expires
The agent downloads the file right away and saves it where you said. If the link has already expired, it runs export_trip again rather than reporting a dead link.
- 05
Flag trips that are still running
For an ongoing trip with no end date, the export holds only the steps so far. The agent says so in its report, so you know to export again after you get home.
What you get back
Example data
Trip: Patagonia (4 Dec 2025 to 19 Jan 2026), 41 steps, 3,870 km
Saved: ~/Trips/patagonia.gpx (route, 41 points)
Saved: ~/Trips/patagonia.md (41 step stories, 18,400 words)
Photos: not included, ask again with photos for a zip
Planned steps without a date: none Other ways to ask
- Export every past trip from 2025 as GPX, one file per trip.
- Back up my current trip as JSON every Sunday night.
- Export my Iceland trip with all photos and videos as a zip.
- Give me the Lisbon part of my Portugal trip as Markdown only.
Before you automate it
What Polarsteps allows, and what to know first
- Polarsteps cannot export a trip to PDF; the help center answers that question with "You cannot do this right now".
- The Polarsteps "Download my data" archive is JSON for everything except photos, so you need a JSON reader to open it, and Polarsteps support does not help with the data after you download it.
- Inside the Polarsteps archive, each trip has its own folder under user_data > trip, with photos sorted by step, locations.json for the coordinates and trip.json for the step texts.
- On polarsteps.com, "Download my data" asks for your password after "Start My Archive", and the archive arrives as an email link, not as a direct download.
Every tool here only reads, so it can run on a schedule from n8n, Make, Zapier or cron without waiting for your OK.
Sources: Polarsteps Help: How can I export a copy of my data? · Polarsteps Help: Can I export my trip into a PDF file?
REST
Call export_trip from a script
curl
curl https://cotlet.dev/api/v1/polarsteps/export_trip \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"trip_id":"16720458","format":"gpx","include_media":false}' Example response
{
"trip_id": "16720458",
"format": "gpx",
"download_url": "https://example.com/exports/16720458.gpx",
"expires_at": "2026-10-11T15:00:00+02:00",
"steps": 41
} MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is polarsteps_export_trip. Example data.
Schedule it in n8n, Make, Zapier or cronTools
Polarsteps tools this automation uses
| Tool | Parameters |
|---|---|
| list_trips | status, limit |
| export_trip | trip_id, format, include_media |
Frequently asked questions
Can I export a trip I follow but did not make?
No. list_trips returns the trips on your own Polarsteps account, and export_trip works on those. A trip of someone you follow belongs to their account.
Give your agent access to Polarsteps.
Free 7-day trial with 5,000 credits, no card needed. Cotlet is independent and not affiliated with Polarsteps.