# Export Screen Time data

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

[Download for Mac](https://apps.apple.com/us/app/exporter-notes-to-markdown/id6741618455?mt=12)

## 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`

```markdown
---
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

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

How it works: [Screen Time docs](https://exporter.dev/docs/screen-time) · Guides: [Screen Time history](https://exporter.dev/guides/screen-time/keep-screen-time-history)

## Questions

### 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](https://exporter.dev/docs/mcp).

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

```sh
claude mcp add --transport http exporter http://localhost:8744/mcp
```

## Related

- [Screen Time history](https://exporter.dev/guides/screen-time/keep-screen-time-history): Every day kept as a file
- [MCP server](https://exporter.dev/docs/mcp): Connect Claude and other agents
- [CLI](https://exporter.dev/docs/cli): Every command, flag and exit code

---

human version: https://exporter.dev/screen-time
every page: https://exporter.dev/llms.txt