MCP Server for Things3
This MCP server provides integration with Things3, allowing you to create and manage tasks and projects through the MCP protocol. It includes special support for synchronization with Agenda projects.
Features
- Create new projects in Things3
- Create new to-dos with detailed properties
- Synchronize projects between Agenda and Things3
- List current tasks and projects
- AppleScript integration for data retrieval
Installation
- Ensure you have Python 3.8+ and Things3 installed
- Clone this repository
- Install dependencies: ```bash pip install -e . ```
Usage
The server provides several tools:
create-things3-project
Creates a new project in Things3 with the following options:
- title (required)
- notes
- area
- when
- deadline
- tags
- completed
- canceled
create-things3-todo
Creates a new to-do in Things3 with the following options:
- title (required)
- notes
- when
- deadline
- checklist
- tags
- list
- heading
- completed
- canceled
- reveal
sync-agenda-project
Creates a Things3 project that mirrors an Agenda project:
- title (required)
- notes
- area
Development
The server uses:
- x-callback-url for creating items in Things3
- AppleScript for retrieving data from Things3
- MCP protocol for communication
License
MIT