Arlet

Connect Japan Bus Timetables (GTFS) to Claude Code

Query Japan Bus Timetables (GTFS) directly from Claude Code. Arlet links the two through one MCP connection and takes care of API keys.

This server connects your AI client to the GTFS data repository (gtfs-data.jp), operated by the Association for Promotion of Infrastructure Geospatial Information Distribution (AIGID). The repository aggregates GTFS-JP feeds β€” the Japanese Ministry of Land, Infrastructure, Transport and Tourism's standard bus data format β€” from roughly 400 operators in 40 of Japan's 47 prefectures.

Coverage is mostly community and regional bus services outside the largest cities: major metropolitan operators (Toei, Keio, Odakyu, Hankyu, Kintetsu, Nishitetsu and the like) and almost all railways are not in this repository. Rail and Tokyo-area services are published through ODPT instead.

Key features:

  • Search feeds by operator name, feed name or prefecture, with each feed's Creative Commons licence and validity period.
  • Search stops inside a feed by name substring, returning stop_id and coordinates.
  • List the routes a feed contains.
  • Get departures from a stop for a given service date (default: today in Japan). The feed's calendar and calendar exceptions are resolved so only trips that actually run on that date are returned, sorted by time with route name and headsign.

The repository's API serves feed metadata; the actual timetable is a GTFS ZIP per feed. This server fetches the ZIP on demand with an in-process cache and a size cap, so very large feeds may be rejected. Data is static timetables (no realtime positions or delays).

How to connect Japan Bus Timetables (GTFS) to Claude Code

  1. 1

    In the Arlet dashboard, open Data tools, find Japan Bus Timetables (GTFS) and switch it on. No API key setup is needed.

  2. 2

    In your terminal, run claude mcp add --transport http arlet https://mcp.arlet.dev/mcp/ to add Arlet as an MCP server.

  3. 3

    Start Claude Code, run /mcp, select arlet and click Authenticate.

  4. 4

    Your browser opens. Sign in with Google and click Allow on the consent screen. The connection is complete.

The connection is per user and works across every project on the same machine.

Use Japan Bus Timetables (GTFS) with other AI clients