使用说明
Dayflow MCP server
[!IMPORTANT] Superseded. Dayflow 2.1.0 ships an official MCP server built into the app - run
dayflow mcpafterdayflow link, see JerryZLiu/Dayflow and the closing comment on #181. It covers everything below except raw observations,list_journal_days,get_recent_activityandlist_tracked_days, and adds write access (categories, activity edits, day goals) that this project never had. Left here for history; not maintained going forward.
MCP server for Dayflow screen time tracker. Connects Claude Code (or any MCP client) to your local Dayflow data for querying timeline activities, observations, journal entries, and daily stats. Read-only access - your data never leaves your machine.
Features
- Query timeline activities by day, date range, or keyword search
- Get raw screen observations (granular transcriptions)
- Read journal entries with intentions, reflections, and AI summaries
- Category breakdown and time statistics per day
- Access daily standup entries
- Browse tracked days and recent activity
Tools
| Tool | Description |
|---|---|
dayflow_get_timeline |
Timeline cards for a specific day |
dayflow_get_timeline_range |
Timeline cards across a date range |
dayflow_get_observations |
Raw granular screen observations for a day |
dayflow_get_journal |
Journal entry (intentions, reflections, summary) |
dayflow_list_journal_days |
List days with journal entries |
dayflow_get_categories |
Activity categories with colors and descriptions |
dayflow_get_daily_stats |
Category breakdown and time stats for a day |
dayflow_search_timeline |
Search activities by keyword |
dayflow_get_recent_activity |
Most recent timeline activities |
dayflow_get_standup |
Daily standup entry |
dayflow_list_tracked_days |
List days with tracked data |
Setup
1. Install
bun install
2. Add to Claude Code
claude mcp add dayflow --transport stdio --scope user \
-- bun /path/to/dayflow-mcp/server.ts
3. Verify
In Claude Code, run /mcp and check that dayflow shows as connected.
How it works
The server reads directly from Dayflow's local SQLite database at ~/Library/Application Support/Dayflow/chunks.sqlite. It opens the database in read-only mode, so it cannot modify your data.
Categories are read from macOS UserDefaults (teleportlabs.com.Dayflow domain) with a fallback to distinct values from the database.
Dayflow uses 4 AM day boundaries - a "day" runs from 4 AM on the calendar date to 4 AM the next day.
