Export Screen Time data

One Markdown file per day, kept after macOS deletes the history at about four weeks.

One day, as a file.

Totals are in the front matter. Apps used for under a minute are left out of the table.

2026-09-01.md

---
title: "Screen Time 2026-09-01"
id: "2026-09-01"
created: 2026-09-01T00:00:00
modified: 2026-09-01T00:00:00
tags:
  - "screen-time"
total_screen_time: "3h 51m"
apps_used: 4
domains_visited: 2
---

## App Usage

| App | Duration | Sessions |
|-----|----------|----------|
| Xcode | 2h 4m | 6 |
| Safari | 1h 21m | 11 |
| Messages | 26m | 9 |

## Web Usage

| Domain | Duration | Visits |
|--------|----------|--------|
| developer.apple.com | 38m | 9 |
| github.com | 21m | 7 |

## Notifications

| App | Count |
|-----|-------|
| Messages | 23 |

## Screen Sessions

Total screen on time: 4h 45m

| Start | End | Duration |
|-------|-----|----------|
| 08:52:10 | 12:31:44 | 3h 39m |
| 14:05:02 | 15:10:30 | 1h 5m |

What comes out

One file per day, named by its date, plus a rolling summary.md.

App time

Every app you used for a minute or more that day, with its time and number of sessions.

Websites

Time and visits per domain.

Notifications

How many each app sent you.

Screen sessions

When the screen came on and went off, and the total time it was on.

A summary

summary.md adds up top apps and daily totals over the days the latest sync read, about the last four weeks.

Kept past four weeks

Exporter never deletes a day file, so the archive keeps growing after macOS drops the old days. The folder is the only copy of those days: back it up.

How it works

1Connect Screen Time
A panel opens in the Knowledge folder where macOS keeps Screen Time: press Select this folder. Then choose an export folder.
2Pick your days
Tick days in a list you can sort by busiest.
3It syncs
Press sync now. Each later sync adds the days since the last one.

How it works: Screen Time docsGuides: Screen Time history

Questions

Still have questions? Get in touch

Can I get Screen Time as a CSV?

Not from Apple: Screen Time only shows its charts in System Settings. Exporter's files are Markdown tables with the totals in YAML, which scripts, Dataview and spreadsheets can read.

What is free?

The 10 newest days you ticked at your first sync. They stay the free ten, so later days need the unlock, a one-time purchase in Exporter.

Is anything uploaded?

No. Exporter reads Screen Time and writes the files on your Mac. No account, no server.

Ask Claude about your days

Exported days are files Exporter's local MCP server can list and read. Set it up.

Connect Claude Code.

Then ask: “How has my screen time changed since I deleted the news apps?” Claude reads the day files you exported.

$ claude mcp add --transport http exporter http://localhost:8744/mcp

Screen Time historyEvery day kept as a file

MCP serverConnect Claude and other agents

CLIEvery command, flag and exit code