Whereabot — Claude Code MCP server: features and setup
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.
MIT updated 2026-11-15
claude mcp add --transport http whereabot https://relay.whereabot.io/mcpWhat Whereabot 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.
What it helps with
- 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 for the agent
- 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.
How to install Whereabot
Platform CLI: remote server
claude mcp add --transport http whereabot https://relay.whereabot.io/mcpPlatform CLI: remote server
codex mcp add whereabot --url https://relay.whereabot.io/mcpConfig file
{
"mcpServers": {
"whereabot": {
"url": "https://relay.whereabot.io/mcp"
}
}
}Config file
{
"servers": {
"whereabot": {
"type": "http",
"url": "https://relay.whereabot.io/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http whereabot https://relay.whereabot.io/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Whereabot
How do I install Whereabot in Claude Code?
Add the MCP server with claude mcp add --transport http whereabot https://relay.whereabot.io/mcp. Sign in to the phone app with Apple or Google, then run /mcp in Claude Code and authenticate with that same account.
What does Whereabot do?
It gives an agent the phone's GPS location when asked. The phone owner must consent to each request.
How does Whereabot work on Android?
Keep the app running in the foreground while the agent waits for a response. On iOS, push notifications let the app answer in the background.