mcp server

whereabot

Let your AI agent ask your phone where you are, with consent. Remote MCP server (OAuth, no API keys) + iPhone app/PWA. Rust, Tauri, self-hostable.

whereabot/whereabotcommunitylistedunreviewed

Use tool

Set up

Hosted by its author. Add the URL to your agent — nothing to install.

~/Library/Application Support/Claude/claude_desktop_config.json

Settings → Connectors → Add custom connector

Name: whereabot
URL:  https://relay.whereabot.io/mcp

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 31, 2026

Whereabot

Let your AI agent ask your phone where you are, on demand. You host the relay. Sign-in and user data live in Supabase.

flowchart LR
  Agent["AI agent"] -->|"MCP or HTTP"| Relay["Relay (Rust)"]
  Relay -->|WebSocket| Phone["Phone app (Tauri)"]
  Phone -->|"GPS fix"| Relay
  Relay -->|"answer"| Agent

The relay keeps no location history. It sends a ping, the phone reads its GPS now, and the answer goes back to the agent. What is stored, for how long, and who sees your location: privacy.

Status

Early MVP, in beta. iOS answers in the background through push. Android answers only while the app is open. See the roadmap.

Repo layout

Path	What
`server/`	Rust relay (axum). Agents call it over HTTP or MCP; the phone holds a WebSocket to it.
`app/`	Tauri v2 phone app (Android / iOS). Signs in, then answers pings with a GPS fix.
`supabase/`	Database migrations and tests.
`infra/`	OpenTofu for the dev and prod environments.
`scripts/`	Local dev, end-to-end check, deploy, hook install.
`docs/`	Source of the docs site.
`site/`	Landing page and OAuth consent page.
`docs-site/`	VitePress build of the docs site.
`design-system/`, `brand/`	Shared CSS tokens and components; logo files and usage rules.

Connect your agent

Install the app: see Get started on whereabot.io, or install from the browser.
Sign in with Apple or Google on the phone.

Add the relay to your agent:

claude mcp add --transport http whereabot https://relay.whereabot.io/mcp

In Claude Code run /mcp and sign in with the same Apple or Google account as on the phone. You never paste a token.
On Android, keep the app open while the agent asks, until Android push ships.

Relay URLs: live URLs. The tool and its arguments: protocol.

Self-host

Run your own relay and Supabase project with the OpenTofu code in infra/. Steps: infra/README.md. Build the app with your Supabase and relay values (app/.env.example), and add your relay to your agent. To run everything on one computer first: local quick start.

Docs

All docs, with the generated MCP and wire references: whereabot.io/docs. In this repo:

Architecture: components, sign-in and ping flow, security, limits
Protocol: HTTP, MCP and WebSocket at intent level
Request flow: every state, notification and agent result of one request
Location sharing: let another person's agent ask for your location
Privacy: what is stored, retention, who sees your location
Operations and infrastructure: how it runs, deploys and releases
Prior art and roadmap
Listings: MCP directories, server.json, how to publish

Community

Contributing: local setup, hooks, rules, adding a migration
Security policy: report vulnerabilities privately
Code of conduct

License

MIT. Third-party material: THIRD_PARTY_NOTICES.md.