Guides / Claude Desktop MCP

Query Your GPS Data with Claude Desktop (MCP)

Geomanic provides an MCP server so AI assistants can work with your travel data. Once connected, you can ask Claude Desktop things like “How many days did I spend in Spain last year?” or “What was my longest trip in June?” — and it answers from your real GPS data. Setup takes a few minutes.

1. Generate your MCP API key

Log in to Geomanic and open the Data page. In the MCP Integration tile, generate your personal MCP API key. Treat it like a password — you can regenerate it there at any time if it is ever compromised.

2. Install the Claude Desktop skill

The easiest way is the ready-made skill:

1. Download a ready-to-use SKILL.md — with your key already included — directly from the MCP Integration tile on the Data page.
2. In Claude Desktop, open Settings → Skills → Add → Upload Skill and select the downloaded file.
3. Start a new conversation and ask Claude about your travel data.

Alternatively, download the skill template from the geomanic-mcp repository (skills/claude/SKILL.md) and replace YOUR_API_KEY with your actual key.

3. Other MCP clients

• OpenClaw — install the skill from ClawHub: /skills install @weltspion/geomanic, then set your key with /secrets set GEOMANIC_TOKEN YOUR_MCP_KEY.
• Cursor — use the Node.js bridge and config template from the repository (bridge/config/cursor/mcp.json).
• Any remote MCP client — connect directly to https://geomanic.com/api/v1/mcp with the header Authorization: Bearer YOUR_MCP_KEY.

What you can do

The Geomanic MCP server exposes these tools:

• get_statistics — aggregated distance, speed, altitude, and per-country day counts for any period
• list_waypoints / get_waypoint — browse and inspect your recorded positions
• create_waypoint / update_waypoint / delete_waypoint — manage waypoints in natural language
• get_date_range — earliest and latest recorded dates

Full parameter documentation is available in the repository docs.

Frequently asked questions