https://github.com/rollecode/dayflow-mcp
MCP server for Dayflow screen time tracker - query timeline, observations, journal entries, and activity stats
https://github.com/rollecode/dayflow-mcp
Last synced: 27 days ago
JSON representation
MCP server for Dayflow screen time tracker - query timeline, observations, journal entries, and activity stats
- Host: GitHub
- URL: https://github.com/rollecode/dayflow-mcp
- Owner: rollecode
- Created: 2026-04-02T13:32:46.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T13:38:04.000Z (about 2 months ago)
- Last Synced: 2026-05-02T13:33:29.100Z (28 days ago)
- Language: TypeScript
- Size: 20.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
Dayflow MCP server
  
MCP server for [Dayflow](https://github.com/JerryZLiu/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
```bash
bun install
```
### 2. Add to Claude Code
```bash
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.
## Requirements
- [Bun](https://bun.sh) runtime
- [Dayflow](https://github.com/JerryZLiu/Dayflow) macOS app with at least one recorded session
- macOS (Dayflow is macOS-only)