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

1. Ensure you have Python 3.8+ and Things3 installed
2. Clone this repository
3. Install dependencies:
   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