MCP Server

Connect your location data to AI assistants

The Model Context Protocol (MCP) lets AI assistants like Claude call tools directly. The Geolocate Me MCP server gives your AI assistant access to your GPS location — just ask "where am I?" and it calls the tool automatically.

No curl commands. No manual API calls. Just natural language.

get_current_location
  Get the most recent GPS coordinates of your tracked device.
  No parameters required.

get_location_history
  Get location history with optional time filters.
  Parameters:
    hours (optional) — last N hours of history
    from (optional) — ISO 8601 start timestamp
    to (optional) — ISO 8601 end timestamp

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "geolocate-me": {
      "command": "npx",
      "args": ["-y", "geolocate-me-mcp"],
      "env": {
        "GEOLOCATE_DEVICE_ID": "your-device-id",
        "GEOLOCATE_BOT_TOKEN": "your-bot-token"
      }
    }
  }
}

Replace the device ID and bot token with your credentials from the Geolocate Me app (Settings > Copy All Credentials).

Restart Claude Desktop after saving.

Add to your project's .mcp.json:

{
  "mcpServers": {
    "geolocate-me": {
      "command": "npx",
      "args": ["-y", "geolocate-me-mcp"],
      "env": {
        "GEOLOCATE_DEVICE_ID": "your-device-id",
        "GEOLOCATE_BOT_TOKEN": "your-bot-token"
      }
    }
  }
}

Restart Claude Code to load the server.

npm install geolocate-me-mcp

Or run directly:

  GEOLOCATE_DEVICE_ID=xxx \
  GEOLOCATE_BOT_TOKEN=xxx \
  npx geolocate-me-mcp

GEOLOCATE_DEVICE_ID (required)
  Your device UUID from the Geolocate Me app.

GEOLOCATE_BOT_TOKEN (required)
  Your bot token from the Geolocate Me app.

GEOLOCATE_API_URL (optional)
  Default: https://geolocateme.guleki.com
  Override if using a custom server.

Once configured, ask your AI assistant:

• "Where am I right now?"
• "Show my location history for the last 6 hours"
• "Where was I yesterday between 9am and 5pm?"
• "Have I been at the same location all day?"

The assistant will call the appropriate tool and return your GPS coordinates with accuracy and timestamps.

In the Geolocate Me app:

1. Open Settings (gear icon on the dashboard)
2. Tap "Copy All Credentials" or "Copy Device ID"
3. Paste into your MCP configuration

Your bot token is shown once during initial setup. You can also find it in Settings > Copy All Credentials.