Skip to main content

Install

This puts gps-mcp on your PATH (same package as gps).

Cursor / Claude Desktop

Using environment variables:
Read-only agent session:

Verify

After connecting, list tools in your client. You should see gps_whoami, gps_list_accounts, gps_list_apps, gps_list_tracks, and the rest of the registry, plus gps_search_capabilities.

Multi-account MCP

Configure accounts in ~/.config/gps/config.json (each with credentialsPath). Tools accept an optional account argument. See Multi-account and apps. Credentials: Authentication.