StayFree connector for Claude
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
StayFree connector for Claude
An unofficial MCP server that lets Claude read your StayFree screen time: every app and website, from your phone, browsers and computers. Then you can ask questions about your habits in plain language.
You run your own copy for free on your own Cloudflare account. It needs no password. It joins your StayFree device group with a normal pairing code, the same way you'd link a new phone.
Not affiliated with StayFree or Sensor Tower. StayFree has no public API, so this uses the same sync API the StayFree browser extension uses. It could break if they change it. Only use it with your own data.
What you can ask Claude
"How much screen time did I have today? What took up the most?"
"Compare my phone use this week to last week."
"How much YouTube have I watched this month, and what time of day do I usually watch it?"
"What was I doing on my phone between 11pm and 2am last night?"
"Which websites do I spend the most time on during school hours?"
"What usage limits do I have set?"
Related MCP server: Whoop MCP Server
Tools
Tool | What it does |
| Total, daily average, and per-device, per-day and per-hour totals, plus top apps and top websites for a date range. Can filter by app, platform or device |
| One app or site in detail: time per day and hour, number of sessions, median and longest session, first and last use, recent sessions |
| Everything used on a given day, in order, with start and end times |
| Your synced usage limits, blocked keywords, categories and ignore list |
| The phones, browsers and computers in your StayFree group |
| Whether the connector is paired, and your time zone |
| Pair or unpair the connector |
Time where sessions overlap on the same device (a website and the browser it's open in, for
example) is counted once. Time on different devices is added together. Android apps show
their real names (YouTube, not com.google.android.youtube).
Setup (about 5 minutes, all in the browser)
You need StayFree's cross-device sync set up already. For example, the Chrome extension should be linked to your phone under Dashboard → Manage Devices. You also need a free Cloudflare account and a GitHub account.
Click Deploy to Cloudflare above. Cloudflare copies this repo into your GitHub and asks for:
TIMEZONE: your time zone, e.g.Asia/Vientiane,America/New_YorkorEurope/London(full list).MCP_SECRET: a long random string you make up (letters and numbers, at least 16 characters). Treat it like a password.
Click Create and deploy. When it finishes, you'll see a Worker URL like
https://stayfree-mcp.<your-subdomain>.workers.dev.In Claude, go to Settings → Connectors → Add custom connector. Use this URL and leave the OAuth fields empty:
https://stayfree-mcp.<your-subdomain>.workers.dev/mcp/<your MCP_SECRET>Ask Claude "connect to StayFree". Claude gives you a pairing code.
In the StayFree browser extension, open Dashboard → Manage Devices → Connect Device → Enter a Code and type the code. A device called "Claude connector" joins your group.
Ask Claude "how much screen time did I have today?"
You can also pair the other way round. Get a code from one of your StayFree apps and tell Claude "connect to StayFree with code 123456".
Security and privacy
Your screen time stays between StayFree's servers, your own Worker and Claude.
The connector URL contains your
MCP_SECRET. Anyone with the URL can read your screen time, so don't share it. To change it, go to Workers & Pages → stayfree-mcp → Settings → Variables and Secrets, then update the connector URL in Claude.The connector is a member of your device group, and it shows up in StayFree's device list. To revoke it, remove "Claude connector" in Manage Devices, or ask Claude to
disconnect.The only things the connector stores (in Workers KV) are its own random device ID, your group key and a cache of app names. It never stores your usage data.
How it works
StayFree's apps upload usage sessions to api.stayfreeapps.com, and devices in the same group
can read each other's sessions. On first use, this Worker creates its own random 13-character
device ID. It registers that ID the same way the extension does, then joins your group with a
pairing code. After that, GET /v1/sync/devices/sessions returns start times and durations for
every Android, iOS, Windows, Mac and Linux app and every website in the group. The Worker splits
them into days and hours in your time zone.
Development
npm install
npm test # aggregation and time zone tests
npm run typecheck
cp .dev.vars.example .dev.vars # set MCP_SECRET
npm run dev # http://localhost:8787/mcp/<MCP_SECRET>License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read your tracked time and projects, pause tracking or add a note, from Claude or ChatGPT.
Your Apple Health data, food diary and lifts, for ChatGPT, Claude and Gemini. Approved on iPhone.
Your Telegram, WhatsApp, Instagram, mail and calendar in Claude or ChatGPT. Never sends messages.
Read-only Google Ads, GA4 and Search Console data for Claude, with no Google Cloud setup.
Related MCP Servers
- AlicenseAqualityBmaintenanceProvides Claude access to RescueTime productivity data, enabling users to query daily summaries, top activities, category breakdowns, and productivity trends through natural language.5MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to read your Whoop recovery, sleep, cycle, and workout data through natural language queries.67 npmMIT
- AlicenseNot gradedqualityDmaintenanceGives Claude read access to wearable health data from Fitbit or Wear OS devices via the Google Health API, exposing tools for metrics like steps, heart rate, sleep, and workouts, plus a computed recovery score.1MIT
- AlicenseBqualityCmaintenanceEnables Claude to interact with Apple apps on macOS including Mail, Calendar, Contacts, Reminders, Notes, and iCloud Drive for personal productivity tasks like triaging email, managing calendar, and cross-app context.769MIT