# Things MCP

Read-only MCP server for **Things 3** — reads completed tasks from the local SQLite database for analysis and reflection.

## Tools

| Tool | Description |
|------|-------------|
| `get_completed_by_date` | Tasks completed on a specific date |
| `get_weekly_summary` | Weekly summary (Mon–Sun) grouped by day |
| `get_project_report` | Tasks by project within a date range |

## Build

```bash
npm install
npm run build
```

## Claude Desktop config

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "things": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/things-mcp/dist/index.js"]
    }
  }
}
```

Replace `/ABSOLUTE/PATH/TO` with the actual path to this project.

## Data source

Reads from the Things 3 SQLite database at:
```
~/Library/Group Containers/JLMPQHK86H.com.culturedcode.ThingsMac/ThingsData-*/Things Database.thingsdatabase/main.sqlite
```

The database is opened in **read-only** mode — Things data is never modified.