{"slug": "fokus-a-local-macos-site-blocker-and-screen-time-tracker-with-an-mcp-server", "title": "Fokus, a local macOS site blocker and screen time tracker with an MCP server", "summary": "Fokus, a local macOS website blocker and screen-time tracker, ships a read-only MCP server called fokus-mcp that lets Claude and other MCP clients query usage data through six tools including fokus_today, fokus_usage and fokus_weekly_report. The app blocks distracting sites in Chrome, Safari and Edge without a browser extension, requires macOS 15 or later, and keeps all data on the Mac with no account, cloud or subscription. Fokus also bundles the focus_coach and weekly_review prompts, which surface in Claude Code as /mcp__fokus__focus_coach and /mcp__fokus__weekly_review.", "body_md": "**A local website blocker and screen time tracker for macOS.** Fokus blocks distracting sites in Chrome, Safari and Edge without a browser extension, and shows you where your time on the Mac actually goes, per app and per website, hour by hour. No account, no cloud, no subscription. Everything stays on your Mac.\n\nIt also ships an MCP server, so Claude (or any MCP client) can read your usage data and answer questions like \"When do I lose focus during the week?\".\n\nEnglish and German, follows your Mac's language.\n\n[**Latest release**](https://github.com/Jnooo-cloud/fokus/releases/latest) → `Fokus-<version>.dmg`\n\n1. Open the DMG and drag Fokus into Applications.\n2. Open Fokus. macOS blocks it the first time because it is not notarized yet. Close the warning with \"Done\".\n3. System Settings → Privacy & Security → scroll down → next to \"Fokus was blocked\", click \"Open Anyway\".\n4. Onboarding walks you through the browser permission, your first block list and launch at login.\n\nRequires macOS 15 or later. Installed apps check for updates every 6 hours and install them with one click. Every update is signed, and the app rejects archives that don't match the key built into it.\n\n**Blocking**\n\n- Sessions with a fixed duration or until a set time, in three levels: Flexible, Commit and Hard Mode\n- Schedules that start on their own, e.g. Mon to Fri, 9 to 5\n- Per-subdomain exceptions: block facebook.com, keep business.facebook.com open\n- Allowlist mode: everything is blocked except your exceptions\n- Block apps, they get closed when opened\n- Unlocking takes friction: give a reason, wait, hold. The wait grows with every unlock that day, and there is a daily limit\n- Hard Mode: no quitting, no unlocking, only an emergency exit with a 5 minute wait\n- Restarts itself after a crash or force quit\n\n**Tracking**\n\n- Time per app and per website, hour by hour, including Chrome app windows\n- Focus score, daily timeline, comparison with yesterday\n- Weekly report with a heatmap, your biggest time sinks and concrete suggestions\n- Your own categories with subcategories, e.g. Distraction › Shopping\n- Optional page titles with rules on top, e.g. \"YouTube with *tutorial* in the title counts as research\"\n- Counts blocked attempts and stores why you unlocked\n- Light and dark mode\n\nFokus includes a read-only MCP server (`fokus-mcp`). It tells the agent what it can see and how to read the numbers, so there is nothing to explain first.\n\n| Tool | What it returns | \n|---|---|\n| `fokus_today` | Today hour by hour, running sessions, unlocks, blocked attempts | \n| `fokus_usage` | Any date range: per day, per category, top apps and websites | \n| `fokus_weekly_report` | This week against last week, biggest distractions, suggestions | \n| `fokus_unlocks` | Every unlock with the reason you typed | \n| `fokus_settings` | Block lists, schedules, categories, unlock rules | \n| `fokus_page_titles` | Time per page title, if you turned titles on | \n\nIt also ships two prompts, `focus_coach` and `weekly_review`. In Claude Code they show up as `/mcp__fokus__focus_coach` and `/mcp__fokus__weekly_review`, in Claude Desktop under the + menu. The coach looks at when and where your focus breaks, checks that against your block lists and schedules, and gives you up to three changes to make.\n\nClaude Code:\n\n```\nclaude mcp add --scope user fokus -e FOKUS_BUNDLE_ID=de.jannikhiller.fokus -- /Applications/Fokus.app/Contents/MacOS/fokus-mcp\n```\n\nClaude Desktop, in `~/Library/Application Support/Claude/claude_desktop_config.json` under `mcpServers`:\n\n```\n\"fokus\": {\n  \"command\": \"/Applications/Fokus.app/Contents/MacOS/fokus-mcp\",\n  \"env\": { \"FOKUS_BUNDLE_ID\": \"de.jannikhiller.fokus\" }\n}\n```\n\nIf you built Fokus yourself, use the bundle ID from your `.fokus-local`.\n\nPrefer a skill? Copy [skills/fokus-coach](https://github.com/Jnooo-cloud/fokus/blob/main/skills/fokus-coach) into `~/.claude/skills/`. It holds the same coaching playbook and works in any agent that reads `SKILL.md`.\n\nThere is also a chat tab inside the app (\"Assistant\"). It runs your installed Claude Code in the background with only the Fokus MCP attached: no terminal, no file access, no changes. You need Claude Code installed (`npm install -g @anthropic-ai/claude-code`) and logged in once.\n\nWhatever Claude reads goes to Anthropic. That is time per app and domain, plus page titles only if you turned them on.\n\n- No analytics, no third-party tracking. The app itself sends nothing over the network, except the update check against this repo's releases.\n- It stores seconds per app or domain per hour, not full URLs. Page titles only if you turn them on, and you can delete them any time.\n- Incognito windows are never recorded with titles.\n- Website icons are letters, so no favicon request leaks your browsing.\n- Data lives in `~/Library/Application Support/Fokus/` .\n\nFokus reads the active tab's address through AppleScript (with your permission) every few seconds. Blocked sites get redirected to a local block page, and time gets counted per domain. There is no extension to disable and no proxy in between. Idle time (3 minutes without input) and a locked screen are not counted.\n\n- Blocking works while Fokus is running. Firefox can only be blocked as a whole app.\n- A network filter that covers every browser exists in the code, but it needs a paid Apple Developer account and is off in this version.\n- An admin who really wants to can get around it. Fokus is meant to add friction, not to be a prison.\n- Tested on Apple Silicon with macOS 27 and Chrome. Safari and Edge are supported but less tested.\n\nRequires macOS 15+ and Xcode or the Command Line Tools (`xcode-select --install`).\n\n```\ngit clone https://github.com/Jnooo-cloud/fokus.git\ncd fokus\necho 'FOKUS_BUNDLE_ID=com.yourname.fokus' > .fokus-local\n./scripts/install-local.sh\n```\n\nThe script builds the app, puts it in `/Applications/Fokus.app` and sets up a launch agent that restarts Fokus after a crash. Your own bundle ID keeps the browser permission across rebuilds.\n\n```\nswift test                                # core logic tests\n./scripts/snapshot.sh build/shots --demo  # every screen as PNG, with demo data\n./scripts/release.sh 0.3.0                # DMG plus signed update archive in dist/0.3.0\n```\n\nThe core (sessions, rules, categories, reports) lives in `Sources/ZoneCore` and is tested. The app is in `Sources/Zone`, Fokus-specific parts in `Sources/Zone/Local`.\n\nComing from ActivityWatch? `python3 scripts/import-activitywatch.py` imports your history once.\n\n**Uninstall** (self-built):\n\n```\nlaunchctl bootout gui/$(id -u)/$(grep -o '=.*' .fokus-local | cut -c2-)\nrm ~/Library/LaunchAgents/$(grep -o '=.*' .fokus-local | cut -c2-).plist\nrm -rf /Applications/Fokus.app\n```\n\nFokus is based on [Zone](https://github.com/morajabi/zone) by Mo Rajabi, which brought sessions, schedules and tab redirection. Fokus adds time tracking, reports, categories, unlock friction, Hard Mode, the MCP server, the in-app assistant, the installer and signed updates. Zone's original README is in [docs/zone-README.md](https://github.com/Jnooo-cloud/fokus/blob/main/docs/zone-README.md).\n\nMIT License, see [LICENSE](https://github.com/Jnooo-cloud/fokus/blob/main/LICENSE).\n\n**Deutsch:** Fokus ist ein lokaler Website-Blocker und Zeit-Tracker für den Mac, ohne Konto, ohne Cloud, ohne Browser-Extension. DMG aus dem [neuesten Release](https://github.com/Jnooo-cloud/fokus/releases/latest) öffnen, Fokus in Programme ziehen, öffnen, Meldung mit „Fertig“ schließen, dann Systemeinstellungen → Datenschutz & Sicherheit → „Dennoch öffnen“. Den Rest erklärt die App, auf Deutsch, wenn dein Mac auf Deutsch läuft.", "url": "https://wpnews.pro/news/fokus-a-local-macos-site-blocker-and-screen-time-tracker-with-an-mcp-server", "canonical_source": "https://github.com/Jnooo-cloud/fokus", "published_at": "2026-11-21 09:15:04+00:00", "updated_at": "2026-11-21 09:43:52.801750+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "ai-tools", "ai-products"], "entities": ["Fokus", "fokus-mcp", "Claude", "Claude Code", "Claude Desktop", "macOS", "Jnooo-cloud"], "also_reported_by": [], "takeaway": "Fokus exposes a read-only MCP server with six tools (fokus_today, fokus_usage, fokus_weekly_report, fokus_unlocks, fokus_settings, fokus_page_titles) that any MCP client can register via a single command with the FOKUS_BUNDLE_ID environment variable set to de.jannikhiller.fokus.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/fokus-a-local-macos-site-blocker-and-screen-time-tracker-with-an-mcp-server", "markdown": "https://wpnews.pro/news/fokus-a-local-macos-site-blocker-and-screen-time-tracker-with-an-mcp-server.md", "text": "https://wpnews.pro/news/fokus-a-local-macos-site-blocker-and-screen-time-tracker-with-an-mcp-server.txt", "jsonld": "https://wpnews.pro/news/fokus-a-local-macos-site-blocker-and-screen-time-tracker-with-an-mcp-server.jsonld"}}