Connect an assistant — MCP

Use your trips from Claude, ChatGPT, or Grok via the Model Context Protocol (MCP). Sign in with OAuth, then manage trips and packing lists from your assistant.

Endpoints

MCP server (Streamable HTTP): https://www.packster.app/api/mcp
OAuth authorization server metadata: https://www.packster.app/.well-known/oauth-authorization-server

Setup by host

Claude (claude.ai, Desktop, mobile)

Add a custom connector with the MCP URL below. Claude discovers OAuth automatically (PKCE). Callback: https://claude.ai/api/mcp/auth_callback (and claude.com variant).

Settings → Connectors → Add custom connector
URL: https://www.packster.app/api/mcp
OAuth: automatic (PKCE)

ChatGPT (connectors / apps)

In developer mode, add an MCP connector with the URL below and OAuth. Stable callback when issuer identification is enabled: https://chatgpt.com/connector_platform_oauth_redirect. Otherwise copy the per-connector callback from ChatGPT into your OAuth allowlist via dynamic registration.

Grok (Grok Build CLI)

There is no documented grok.com remote MCP OAuth connector like Claude/ChatGPT. Use Grok Build CLI to add the HTTP MCP server (OAuth handled by Grok), or use device authorization and pass a Bearer token to the xAI Remote MCP API.

grok mcp add --transport http packster https://www.packster.app/api/mcp

Claude Desktop (stdio proxy)

For local stdio, run apps/mcp with PACKSTER_MCP_ACCESS_TOKEN set to an OAuth access token. See docs/mcp/clients.md in the repository.

Tools (v1)

list_trips — List the authenticated user's trips (upcoming order).
get_trip — Get one trip by id (must be owned by the user).
create_trip — Create a new trip for the authenticated user.
update_trip — Update fields on an owned trip.
generate_packing_list — Generate an AI packing list for a trip (uses shared generation allowance).
list_packing_items — List packing items for a trip's active packing list.
update_packing_item — Update a packing item (packed state, quantity, etc.).
get_weather_recommendation — Weather forecast and packing hints for a trip destination.
get_account_quota — Remaining MCP and shared AI allowances (same shape as GET /api/usage).

Fair-use quotas (MCP)

MCP tool calls share the same allowance pools as the web app. Numbers below come from the live product policy.

Plan	MCP tool calls
Free	3 lifetime trial calls
Trip Pass	25 per unlocked trip
Monthly / Annual	150 per rolling 7 days

List generation via generate_packing_list uses the shared generation quota (Free: 3 per 30 days, Trip Pass: 20 per trip, Pro: 100 per 30 days).

When you see USAGE_LIMIT

If a tool returns USAGE_LIMIT, the JSON includes a human-readable message, resetAt when the window resets, and upgradeUrl. Tell the user and do not retry the same call until the limit resets or they upgrade. There are no pay-per-call top-ups.

Operator reference: docs/mcp/clients.md in the repository (callback URLs, manifests, Grok gaps).