things3-mcp

Things3 MCP Server

things3-mcp connects AI assistants and other MCP clients to task management in Things3 on macOS. Users can organize tasks, projects, areas, and tags, apply bulk changes, and search completed work through its 25 tools.

Server facts

things3-mcp

Project

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.

Related MCP servers