# Whereabot

The Whereabot MCP server for Claude Code asks a phone for its current location. The phone responds to each request with its owner's consent.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: whereabot
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/whereabot/whereabot
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/whereabot

## What it does

Whereabot returns a phone's current GPS location to an agent on request. The agent contacts a relay over MCP or HTTP; the phone app receives the ping through a WebSocket and sends back its location. The relay does not keep location history.

The phone app needs an Apple or Google sign-in. A self-hosted setup uses your own relay and Supabase project. On Android, leave the app open while the agent waits for a reply; iOS can respond in the background through push notifications.

## Requirements
- Remote server: `https://relay.whereabot.io/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http whereabot https://relay.whereabot.io/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add whereabot --url https://relay.whereabot.io/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "whereabot": {
            "url": "https://relay.whereabot.io/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "whereabot": {
            "type": "http",
            "url": "https://relay.whereabot.io/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http whereabot https://relay.whereabot.io/mcp
```

## When to use it
- retrieve a phone's current location through an agent
- share location only in response to a request
- run a private relay for location requests

## Example prompts
- Ask Whereabot to get my phone's current location.
- Request my location from my phone and return the coordinates.
- Find out where I am now through my relay.

## Similar
- [add-geolocation](https://affpapa.org/en/nevibecode/skills/add-geolocation.md) — skill · ★ 1167 repo stars
- [ev-charger-nearby](https://affpapa.org/en/nevibecode/skills/ev-charger-nearby.md) — skill · 9500 installs
- [mapbox](https://affpapa.org/en/nevibecode/plugins/mapbox.md) — plugin · ★ 87 repo stars
- [metto](https://affpapa.org/en/nevibecode/mcp/metto.md) — MCP server · 339 installs
- [doalu.com where to stay](https://affpapa.org/en/nevibecode/mcp/doalucom-where-to-stay.md) — MCP server
- [Weather Automation](https://affpapa.org/en/nevibecode/skills/weather-automation.md) — skill · 4700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
