Server facts
things3-mcp
Project
- Author
- urbanogardun
- Repository
- github.com/urbanogardun/things3-mcp
- License
- MIT license
- Category
- Productivity
Tech
- Runtime / language
- node
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 25
- Last commit
- Data as of
Overview
Things3 task lists become accessible to MCP clients through tools for finding, creating, editing, completing, reopening, and deleting tasks. Searches can target titles and notes, while list filters select views such as Today or Upcoming. Project tools handle creation, updates, completion, and deletion, with areas providing another level of organization. Tags can be listed with hierarchy information, created, attached, removed, or deleted; task and project operations also create missing tags when referenced. For larger changes, bulk tools move tasks between projects or areas and adjust scheduling dates or deadlines. Logbook searches retrieve completed work within optional date boundaries.
The integration runs on macOS with Node.js, an installed Things3 app, and AppleScript access. Modification, completion, and deletion operations require a Things3 authorization token. Built-in corrections address scheduling conflicts, absent titles, invalid project or area references, and unsupported characters in tag names. Checklist creation uses Things3 URLs rather than AppleScript and may bring the app forward. Because the resulting task is located by title, duplicate titles can lead to an incorrect match. Existing checklists cannot be edited through this integration.
things3-mcp setup notes
- things3-mcp records stdio only; confirm a network transport upstream before planning remote access.