https://github.com/zaydiscold/alltrails-cli-mcp-api
AllTrails CLI (MCP + API) — unofficial AllTrails API map + CLI + MCP: trails, maps, GPS routes, recordings, lists, reviews. The API map is the product.
https://github.com/zaydiscold/alltrails-cli-mcp-api
alltrails api cli gps hiking mcp openapi typescript
Last synced: 1 day ago
JSON representation
AllTrails CLI (MCP + API) — unofficial AllTrails API map + CLI + MCP: trails, maps, GPS routes, recordings, lists, reviews. The API map is the product.
- Host: GitHub
- URL: https://github.com/zaydiscold/alltrails-cli-mcp-api
- Owner: zaydiscold
- Created: 2026-05-26T18:27:54.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-23T03:25:09.000Z (12 days ago)
- Last Synced: 2026-06-23T05:17:41.580Z (12 days ago)
- Topics: alltrails, api, cli, gps, hiking, mcp, openapi, typescript
- Language: TypeScript
- Size: 53.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# AllTrails CLI (MCP + API)
I wanted my AllTrails data — trails, maps, GPS routes, my own recordings and activities — reachable from the terminal and from agents instead of locked inside the app. AllTrails has no public developer API, so I mapped the routes the web and mobile clients actually use, then built a small TypeScript CLI and MCP server on top of that map.
This is unofficial and not affiliated with AllTrails. It maps and drives my own account surfaces; it stores no cookies, tokens, or private ids.
## What it does
- **Search trails** by name, location, or map bounds.
- **Trail details + weather** — full trail payloads plus the weather overview surface.
- **Maps & GPS routes** — static maps, offline-map metadata, GPX, and route geometry.
- **Recordings & activities** — community recordings, your activity list, and activity detail/upload.
- **Lists** — saved and custom lists.
- **Reviews & photos** — trail reviews and the trail/photo surfaces.
```bash
pnpm install
pnpm build
pnpm cli api-map summary --json
pnpm cli trail get 10027248 --detail offline --json
pnpm cli search plan "Half Dome" --lat 37.746 --lng -119.533 --radius 25 --limit 3 --json
```
Live commands read caller-owned auth from environment variables set outside this repo (`ALLTRAILS_ACCESS_TOKEN`, or `ALLTRAILS_COOKIE` with an optional `ALLTRAILS_CSRF_TOKEN`). Writes are real by default and print a stderr warning before mutating; pass `--dry-run` to rehearse without sending. There is no CAPTCHA solving, bot-bypass, TLS impersonation, or stealth code here.
## The map is the point
The headline artifact lives in [`api-map/`](api-map/): an OpenAPI spec, a Markdown route reference, and runnable curl recipes covering roughly 120 endpoints across trails, maps, recordings, activities, lists, reviews, and account surfaces. Every route carries a source label (`browser_observed`, `community_inferred`, `subscription_gated`, `unverified`, and so on) so you can tell evidence quality apart from permission. The CLI and MCP server are just two convenient front-ends for that map.
## Extending it
New routes go in `api-map/` first (OpenAPI + the Markdown table), then surface in the CLI via `cli/src/lib.ts`. Run `pnpm cli api-map routes` to see everything currently wired up, and `pnpm cli request ` to drive a freshly captured route before it gets a dedicated command.
---
Built on the trio pattern (CLI + skill + MCP) pioneered by [Matt Van Horn's Printing Press](https://github.com/mvanhorn/cli-printing-press).
Mapped & built by Zayd Khan ([@ColdCooks](https://twitter.com/ColdCooks) / [zaydiscold](https://github.com/zaydiscold)). MIT © Zayd Khan.