What You Are Making
A Raycast AI prompt that reads yesterday's screen time data from ScreenTimerAI and generates a short daily productivity report.
One keystroke to open Raycast, one prompt, one report. The fastest path from keyboard to insight.
Why Raycast
Raycast is a macOS launcher and productivity tool that replaces Spotlight. It ships with built-in AI chat, clipboard history, snippets, window management, and a growing library of extensions — all accessible from a single hotkey. Its core audience is Mac power users and developers who want fast access to AI, custom commands, and everyday utilities without leaving the keyboard.
Connecting screen time tracking to Raycast makes sense because Raycast is already the fastest way to get things done on your Mac. Adding ScreenTimerAI through the MCP extension means you can summon a full productivity report with a keystroke instead of opening a separate app or browser tab. The MCP protocol makes the connection seamless — Raycast AI discovers the available tools automatically, so there is nothing extra to configure once the server is registered.
Step 1: Connect ScreenTimerAI To Raycast
There are two ways to set this up:
Open Raycast and run the "Install Server" command from the MCP extension.
Fill in the form:
- Name: screentimerai-activities
- Command:
/Applications/ScreenTimerAI.app/Contents/MacOS/activity-mcp-server - Args: (leave empty)
Submit and the server is ready.
If you want to test that Step 1 worked, open Raycast AI Chat and try one of these prompts:
| MCP function | Test prompt |
|---|---|
get_current_activity | @screentimerai-activities What am I doing right now? |
get_activity_logs | @screentimerai-activities Get my raw activity logs for yesterday. |
show_activity_timeline | @screentimerai-activities Show me an activity timeline for yesterday. |
summarize_activity_range | @screentimerai-activities Summarize my activity for yesterday. |
analyze_focus_segments | @screentimerai-activities Analyze my focus segments for yesterday afternoon. |
show_focus_score_timeline | @screentimerai-activities Show me a focus score timeline for today. |
show_focus_score_trends | @screentimerai-activities Show me my focus score last week. |
Step 2: Generate Your Daily Report
Open Raycast AI Chat and type this prompt. Use @screentimerai-activities to explicitly reference the server:
@screentimerai-activities Generate a daily productivity text report based on yesterday's Screen Time AI data.
Follow these steps:
1. Fetch yesterday's activity data from Screen Time AI.
2. Write a short productivity report (~150 words) from the perspective of a dark, witty productivity coach reacting to the data.
Rules:
- Focus more on failures than successes
- Use short, punchy sentences
- Be dark and witty, commanding not polished
- Swearing is allowed sparingly for impact
- Return only the final report text, nothing else
Return the report as plain text directly in the chat.Raycast AI will discover the ScreenTimerAI tools automatically and call them to fetch your data. The report appears right in the Raycast window.
Other Prompts To Try
Once the MCP connection is working, you are not limited to the daily report prompt above. Here are more prompts you can run directly in Raycast AI Chat to explore your screen time data in different ways:
@screentimerai-activities Show me my top 5 apps by time spent yesterday.— Quick breakdown of where your hours actually went, sorted by total usage.@screentimerai-activities How many context switches did I have yesterday afternoon?— See how fragmented your afternoon was and whether you were bouncing between apps or staying focused.@screentimerai-activities Compare my screen time this week vs last week.— Spot trends in your total usage and see if you are spending more or less time at the computer.@screentimerai-activities Analyze my focus segments for yesterday and identify my most productive hours.— Find out when you did your best deep work so you can protect those time blocks going forward.
Each prompt triggers one or more MCP tool calls behind the scenes. Raycast AI picks the right tools, fetches the data, and formats the answer — all within the Raycast window.
Troubleshooting
Server not appearing? Make sure the Raycast MCP extension is installed from the Raycast Store first. Then open Raycast and run "Manage MCP Servers" to verify that screentimerai-activities is listed and its status shows as connected.
AI not calling tools? Use the @screentimerai-activities mention at the start of your prompt to explicitly reference the MCP server. Without the mention, Raycast AI may not know which server to query and will answer from its general knowledge instead.
Command not found? Verify that the binary path is correct: /Applications/ScreenTimerAI.app/Contents/MacOS/activity-mcp-server. ScreenTimerAI must be installed in your /Applications folder. If you moved the app to a different location, update the command path in your MCP server configuration to match.
What Happens Next
Every time you run the prompt, Raycast pulls your latest screen time data through the MCP connection and generates a fresh report.
Bind it to a Raycast hotkey or AI Command for an instant daily check-in.