Fokus, a local macOS site blocker and screen time tracker with an MCP
Fokus launched as a free local macOS site blocker and screen time tracker that pairs automated tab redirection with a dedicated Model Context Protocol server.
By Dillip Chowdary • Nov 21, 2026 • Source: github.com

At a glance
- Product
- Fokus
- Target platform
- macOS 15 or later
- Pricing
- Free open-source software
- License
- MIT License
- Updates
- Signed check every 6 hours
- Limits
- Firefox app-level blocking only
In this post
Developer Jannik Hiller released Fokus, an open-source website blocker and screen time tracking application for macOS that operates without subscriptions, accounts, or browser extensions, as detailed in github.com's report. The desktop tool tracks computer usage hour by hour across local applications and individual websites, introduces customizable friction to prevent impulsive browsing habits, and includes a built-in Model Context Protocol server for local artificial intelligence querying.
This article examines the installation process across Apple operating systems, the tiered blocking friction models, the granular activity tracking features, the Model Context Protocol tools, and the local AppleScript system architecture. It is written for macOS developers, knowledge workers, and privacy-conscious users seeking structured digital distraction control without sending personal activity records to external analytics clouds.
01Desktop application installation and Gatekeeper setup
Fokus requires macOS 15 or later, runs natively on Apple Silicon hardware, and provides full tab-blocking support across Google Chrome, Apple Safari, and Microsoft Edge. Precompiled desktop binaries distribute as disk image archives, while an internal background daemon checks the project repository for signed software updates every six hours and installs them in one click.
- Disk image transfer Open the downloaded disk image and drag the Fokus application bundle directly into Applications.
- Gatekeeper dismissal Launch the application and click Done on the initial macOS security warning regarding unnotarized binaries.
- Security clearance Open System Settings, scroll to Privacy and Security, and click Open Anyway next to the blocked application notice.
- Onboarding configuration Complete the initial setup walkthrough to grant browser automation permissions, configure block lists, and enable launch at login.
The software interface defaults to English or German according to local system configuration files. The initial onboarding workflow guides operators through granting AppleScript automation permissions, establishing baseline block lists, and registering background startup tasks so protection resumes automatically whenever the workstation boots.
02Session enforcement tiers and unlock friction
Operators can schedule recurring focus routines across defined work windows, such as Monday through Friday from nine to five, or trigger ad-hoc sessions lasting for designated periods. The filtering engine supports granular subdomain exceptions, allowing operators to block access to consumer networks like facebook.com while keeping corporate portals like business.facebook.com available.
| Mode | Enforcement level | Unlock restrictions | | Flexible | Standard session | Manual unlock with baseline friction | | Commit | Escalating delay | Reason prompt, holding delay, growing wait times, and daily unlock limits | | Hard Mode | Total lockdown | Application quitting disabled, unlocking blocked, and five-minute emergency exit |
Restricting access introduces deliberate mental barriers: clearing an active block requires writing an explanation, waiting for an interactive countdown timer, and maintaining continuous physical contact on an unlock button. These waiting intervals compound with each successive unlock throughout the day, while Hard Mode strictly prohibits quitting the application or bypassing barriers outside a five-minute emergency pause.
03Hourly activity timelines and category rules
Advertisement
Tech Pulse Daily
Get tomorrow's pulse first
Join engineers who read Tech Pulse before stand-up. Free, weekday mornings.
The integrated tracking subsystem monitors active computer usage across individual applications and web browsing domains hour by hour, including standalone Chrome web application windows. The interface renders visual focus scores, chronological activity timelines, comparative performance metrics against previous daily totals, and weekly analytical summaries featuring distraction heatmaps and workflow recommendations.
Time records organize into user-defined categories and subcategories, such as designating online storefronts under a Distraction and Shopping hierarchy. The logging engine preserves counts of every thwarted browsing attempt alongside stored justifications provided during manual session unlocks, and offers full compatibility across both macOS light and dark display modes.
Activity classification also supports contextual page title evaluation when operators opt into capturing tab headers. System administrators can construct dynamic sorting rules, ensuring specific media destinations like YouTube videos containing the word tutorial in their title register as productive research rather than recreational entertainment.
04Model Context Protocol tools and coaching
A bundled read-only Model Context Protocol server named fokus-mcp enables external artificial intelligence assistants to inspect local productivity records without manual data exports. Terminal coding tools like Claude Code integrate through user configuration commands referencing bundle identifier de.jannikhiller.fokus, while Claude Desktop connects by defining server execution paths inside its application configuration file.
| Tool | Returned data | | fokus_today | Current day hour-by-hour usage, active sessions, unlock events, and blocked attempts | | fokus_usage | Custom date ranges broken down by day, category, and leading applications or domains | | fokus_weekly_report | Week-over-week comparisons, primary distraction sources, and optimization recommendations | | fokus_unlocks | Chronological log of every session unlock accompanied by typed user justifications | | fokus_settings | Active block lists, automated schedules, category trees, and unlock friction parameters | | fokus_page_titles | Active duration per web page title when title recording is explicitly enabled |
The integration packages specialized coaching prompts, including focus_coach and weekly_review, which inspect historical productivity disruptions against active schedules to propose up to three concrete schedule modifications. Furthermore, an embedded Assistant chat tab runs background Claude Code CLI instances with sandboxed permissions, transmitting only domain durations and optional page titles to Anthropic.
05Local tab redirection and data isolation
Website interception functions entirely through periodic AppleScript polling, inspecting active browser tabs every few seconds without background web extensions or network proxy servers. When an operator attempts to access a restricted destination, Fokus redirects the browser tab to a local block page, while suspending duration counting whenever the workstation locks or remains idle for three minutes.
All usage metrics reside locally on the host machine within the Application Support directory, storing seconds spent per application or domain without tracking complete URL query parameters. The application employs simple letter badges instead of external favicon network requests, guarantees that private browsing windows never record page titles, and includes data import scripts for users migrating from ActivityWatch.
Note: Blocking operates only while the application remains active, Firefox is limited to whole-app blocking rather than individual tabs, and full network filtering across all browsers is currently disabled because it requires a paid Apple Developer account. Furthermore, administrative users can bypass local controls since the utility is designed to introduce friction rather than act as an inescapable prison.
Frequently asked questions
Which browsers does Fokus support for website blocking?
Fokus blocks websites in Google Chrome, Apple Safari, and Microsoft Edge without browser extensions. Firefox can only be blocked as an entire application.
How does the Fokus Model Context Protocol server work?
The included fokus-mcp server provides read-only access to hourly screen time, active sessions, unlock reasons, and block settings. Clients like Claude Code or Claude Desktop can query this data for automated weekly reviews.
What are the differences between Flexible, Commit, and Hard Mode?
Flexible and Commit modes introduce growing unlock delays and daily limits to deter browsing distractions. Hard Mode blocks quitting, prevents unlocking, and provides only an emergency exit requiring a five-minute wait.
Does Fokus send private browsing data to external cloud servers?
All activity data stays stored locally on macOS in the Application Support folder without accounts or analytics. The only outbound network activity is an automated update check against GitHub releases every six hours.
Sources
Author
Dillip Chowdary
Writes Tech Bytes coverage of AI, engineering, and the tools that actually ship. Editor of Tech Pulse Daily.
Related on Tech Bytes
Advertisement