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
npm install
npm run build
Claude Desktop config
Add to ~/Library/Application Support/Claude/claude_desktop_config.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.











